Semantic Calculator MCP
About
MCP tool in python for performing various semantic calcualtions
Details
- License
- MIT
Explore
- Calculate semantic similarities between vectors
- Convert text and emoji to vector embeddings
- Calculate helical components for phase angle representations
- Parse and analyze Emojikey V3 strings
- Calculate semantic field distance between dimensions
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Semantic Calculator MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Python 3.10+ (required by MCP SDK)
- Apple Silicon Mac (M1/M2/M3) or Intel Mac
- Claude Desktop application
uv sync
uv pip install -e .
Add this configuration to your Claude Desktop settings (typically ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"Semantic Calculator": {
"command": "arch",
"args": [
"-arm64",
"/Users/rob/.local/bin/uv",
"--directory",
"/Users/rob/repos/mcp-server-semantic-calc",
"run",
"-m",
"semantic_calculator",
"mcp"
]
}
}
}
Important Notes:
- Replace /Users/rob/ with your actual home directory path
- The -arm64 flag ensures native Apple Silicon execution
- Make sure /Users/rob/.local/bin/uv exists (install with curl -LsSf https://astral.sh/uv/install.sh | sh)
from semantic_calculator.core import SemanticCalculator
Once configured in Claude Desktop, you can use it with:
// Convert emoji to vector
const brainVector = semantic_calc_emoji_to_vector({
emoji: "🧠"
});
const artVector = semantic_calc_emoji_to_vector({
emoji: "🎨"
});
// Calculate similarity
const similarity = semantic_calc_cosine_similarity({
vector1: brainVector,
vector2: artVector
});
console.log(Similarity: ${similarity});
Note: All tool functions have been prefixed with semantic_calc_ to avoid naming conflicts with other tools.
python -m semantic_calculator.examples.vector_operations
python -m semantic_calculator.examples.calculate_emoji_similarity
python -m semantic_calculator.examples.analyze_emojikey
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"semantic calculator mcp": {
"mcp-server-semantic-calc": {
"command": "python",
"args": [
"-m",
"semantic_calculator.examples.vector_operations"
]
}
}
}
}McpServers
{
"mcp-server-semantic-calc": {
"command": "python",
"args": [
"-m",
"semantic_calculator.examples.vector_operations"
]
}
}A Python-based MCP tool for semantic operations on vectors, text, and emoji, with specialized support for the Emojikey V3 system.
Features
- Calculate semantic similarities between vectors
- Convert text and emoji to vector embeddings
- Calculate helical components for phase angle representations
- Parse and analyze Emojikey V3 strings
- Calculate semantic field distance between dimensions
Requirements
- Python 3.10+ (required by MCP SDK)
- Apple Silicon Mac (M1/M2/M3) or Intel Mac
- Claude Desktop application
Installation
1. Install Dependencies
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
