@trymesh/mcp

Model Context Protocol server exposing Mesh's code-intelligence tools to MCP-compatible clients (Claude Desktop, Cursor, Cline, Continue, …).

npx -y @trymesh/mcp

Requires Node 20+.

Install in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mesh": {
      "command": "npx",
      "args": ["-y", "@trymesh/mcp"],
      "env": {
        "MESH_WORKSPACE_PATH": "/absolute/path/to/your/project"
      }
    }
  }
}

Restart Claude Desktop. The Mesh tools appear in the tool picker.

Install in Cursor

Settings → MCP Servers → Add. Use the same JSON as above.

Tools

| Tool | What it does | | --- | --- | | workspace.read_file | Read with AST-precise capsule summary. | | workspace.grep | Ripgrep across the workspace, capsule-aware ranking. | | workspace.search_semantic | Embedding-based search via text-embedding-004. | | workspace.patch_file | 6-strategy edit ladder (literal → relative-indent → reverse-trim …). | | workspace.run_command | Execute a shell command in the workspace; output is artifact-stored. | | workspace.ask_codebase | High-level architectural QA over the indexed repo. | | workspace.list_files | Tree listing, capsule-aware. | | workspace.open_artifact | Resume reading a previously-clamped tool result. |

Full list with arg schemas: npx @trymesh/mcp --print-tools.

Environment

| Variable | Purpose | | --- | --- | | MESH_WORKSPACE_PATH | Absolute path to the workspace this MCP server should index. Required. | | MESH_BENCH_RAW | Strip mesh scaffolding (debug only). | | MESH_DEBUG_LLM | Stream LLM request summaries to stderr. |

The server reads the same .mesh/ cache that the mesh CLI maintains for the same workspace — both clients share the index, capsules, and artifact store.

Develop

pnpm --filter @trymesh/mcp dev          # tsx watch
pnpm --filter @trymesh/mcp build
pnpm --filter @trymesh/mcp test

License

Proprietary. See the root LICENSE.