Skip to content

docs: README setup for non-Claude MCP clients (opencode, Cursor, LangChain, Agent SDK)#96

Open
andreinknv wants to merge 1 commit into
colbymchenry:mainfrom
andreinknv:docs/mcp-other-clients
Open

docs: README setup for non-Claude MCP clients (opencode, Cursor, LangChain, Agent SDK)#96
andreinknv wants to merge 1 commit into
colbymchenry:mainfrom
andreinknv:docs/mcp-other-clients

Conversation

@andreinknv
Copy link
Copy Markdown
Contributor

Summary

Adds a "Using with Other MCP Clients" section to the README. The current README only documents the Claude Code / ~/.claude.json setup, which leaves users of other MCP clients (opencode, Cursor, LangChain, the Anthropic Agent SDK) guessing at the right config shape — that's what issues #65 and #79 ask for.

Closes #65, #79.

What's added

A new section right after the existing MCP Tools table, covering five client shapes:

  • opencodeopencode.json mcp.<name> block with type: "local" + command array
  • Cursor~/.cursor/mcp.json mcpServers.<name> block (Anthropic-style stdio shape)
  • LangChain (MultiServerMCPClient) — Python dict with command / args / transport: "stdio". Issue Does it support other AI assistants besides Claude #65 was specifically tripping on SSE config — the section calls out that the server is stdio-only.
  • Claude Agent SDK — Python ClaudeAgentOptions(mcp_servers=...) with allowed_tools=["mcp__codegraph__*"]
  • Generic stdio MCP fallback — a 3-row table (command, args, transport) for any other client, plus a note about --path for clients that don't send rootUri in the initialize request

A closing note points SSE-only clients at supergateway as a stdio→SSE bridge.

Test plan

  • Reviewed the rendered Markdown locally
  • Verified the field names against each client's actual docs:
  • Verified codegraph serve --mcp --path <dir> flag exists in src/bin/codegraph.ts:1031
  • Verified the server reads rootUri from the initialize request in src/mcp/index.ts:257

🤖 Generated with Claude Code

Adds a "Using with Other MCP Clients" section to the README with
copy-pastable config for opencode, Cursor, LangChain
(MultiServerMCPClient), and the Claude Agent SDK, plus a generic
stdio-MCP fallback. Each client gets the exact field names it
actually expects (the existing README only documented the Claude
Code / ~/.claude.json shape).

Notes:
- The CodeGraph MCP server speaks stdio only, so the LangChain
  example explicitly passes `transport: "stdio"` (the issue
  reporter had been trying to use SSE config) and there's a
  closing note pointing SSE-only clients at supergateway as a
  bridge.
- The generic-fallback section documents the `--path` flag for
  clients that don't send a `rootUri` in the initialize request.

Closes colbymchenry#65, colbymchenry#79.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Does it support other AI assistants besides Claude

1 participant