About Cog MCP
Cog MCP is an MCP server published by vitorcalvi in the Developer Tools category: semantic Code Intelligence with Apple Silicon MLX - MCP Server for AI Assistants.
The repository has 17 stars and 4 forks, with the last commit 3 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/vitorcalvi/cog-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (3)
analyze_structureExtract functions and classes from a file
Parameters not published.
generate_embeddingGet 768-dim vector for any text
Parameters not published.
search_codeSemantic search - finds code by meaning
Parameters not published.
Ask AI
Ask AI about Cog MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 2 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
Cog
Semantic code search for AI assistants. Powered by Nomic embeddings on Apple Silicon.
What it does
- Search code by meaning - Find functions that "handle authentication" not just keyword matches
- Analyze structure - Extract functions, classes, and dependencies from any file
- Generate embeddings - 768-dim vectors on Metal GPU (M1/M2/M3)
Requirements
- macOS with Apple Silicon
- Python 3.12+
- Node.js 18+
- uv
Install
git clone https://github.com/vitorcalvi/cog.git
cd cog
# Python engine
cd packages/core && uv sync
# MCP server
cd ../mcp && npm install && npm run build
Index your code
cd packages/core
uv run cog-index ./your/project
Connect to OpenCode
Edit ~/.config/opencode/opencode.json:
{
"mcp": {
"cog": {
"type": "local",
"command": ["node", "/ABSOLUTE/PATH/TO/cog/packages/mcp/dist/index.js"],
"environment": {
"COG_CORE_DIR": "/ABSOLUTE/PATH/TO/cog/packages/core",
"COG_DB_PATH": "/ABSOLUTE/PATH/TO/cog/packages/core/cog_memory"
},
"enabled": true
}
}
}
Replace /ABSOLUTE/PATH/TO with your actual path.
Use in OpenCode
> Search my codebase for user authentication
> Analyze the structure of src/api.py
> Find database connection functions
Tools
| Tool | Description |
|---|---|
search_code |
Semantic search - finds code by meaning |
analyze_structure |
Extract functions and classes from a file |
generate_embedding |
Get 768-dim vector for any text |
Test it works
| Package | Tests | Coverage |
|---|---|---|
| Python Core | 60 | 100% |
| TypeScript MCP | 35 | 98.7% |
Run tests:
cd packages/core
uv run pytest
cd packages/mcp
npm test
License
MIT © Vitor Calvi
README fetched from the repository 2 days ago. The original is authoritative.