Skip to content

feat(integrations): SP-4 multi-platform MCP — codetalker-mcp alias + per-agent docs#3

Merged
OpenCircuitDev merged 1 commit into
mainfrom
feat/codetalker-mcp-multiplatform-docs
May 10, 2026
Merged

feat(integrations): SP-4 multi-platform MCP — codetalker-mcp alias + per-agent docs#3
OpenCircuitDev merged 1 commit into
mainfrom
feat/codetalker-mcp-multiplatform-docs

Conversation

@OpenCircuitDev

Copy link
Copy Markdown
Owner

Summary

Implements SP-4 of the commercial launch master plan: expand codetalker from "Claude Code TTS" to "TTS for any MCP-compatible AI coding agent" via packaging + discoverability changes (no daemon code touched).

The existing MCP server (claude-code-talker-mcp-stdio) already works with any MCP client; this PR makes that fact findable and frictionless for users of the other agents in the AI-coding ecosystem.

What's in this PR

1. codetalker-mcp console_script alias

  • core/pyproject.toml adds codetalker-mcp = "claude_code_talker.mcp_stdio:main"
  • The verbose claude-code-talker-mcp-stdio stays for backwards compat
  • One-pip-install gets users both names

2. Per-agent integration guides — docs/integrations/

Twelve installable platforms documented with copy-paste config snippets:

Tier Agent Status
T0 Claude Code canonical
T1 Cursor ready
T1 Cline (VS Code) ready
T1 Continue.dev ready
T1 Windsurf (Codeium) ready
T1 Zed ready
T1 Codex CLI (OpenAI) ready
T1 Goose (Block) ready
T1 Roo Code ready
T1 Replit Agent ready (with remote-MCP caveat)
T1 AWS Kiro ready
T1 Google Antigravity ready
T2 Aider v1.x stub (Pro Plus, SP-10)
T2 JetBrains AI Assistant v1.x stub (Pro Plus, SP-10)

3. MCP registry submission metadata — docs/integrations/mcp-registries.md

Canonical YAML metadata + submission status for the 8 MCP registries codetalker will be listed in at v1 launch (registry.modelcontextprotocol.io, PulseMCP, MCP.so, mcpservers.org, GitHub MCP Registry, awesome-list, Anthropic Claude Marketplace, Continue Hub).

4. README.md — "Use with other AI-coding agents" section

Top-level discoverability for the new docs.

What's NOT in this PR (intentionally split out)

  • Session-scoped MCP tools (narrate with voice/mode args, session_set_mode, session_set_mute, session_list) — these touch server.py's register_tools() and the shim's _PROXY_TOOLS. Bigger, riskier change; ships as a follow-up PR.
  • Pro entitlement gating for character tools (attach_character, list_characters) — those tools don't exist yet; they ship as part of SP-2 (character system cleave to private repo) + SP-3 (entitlement server).
  • MCP registry submissions themselves — manual at v1 launch per SP-7 in the master plan; the manifest data is here ready for that.

Test plan

  • cd core && pip install -e . succeeds and exposes both claude-code-talker-mcp-stdio and codetalker-mcp on PATH
  • codetalker-mcp --version (or invocation via an MCP client) launches the same shim as the verbose name
  • Render each docs/integrations/*.md file in a Markdown viewer — verify code blocks lex correctly and table formatting is intact
  • Pick one non-Claude-Code agent locally (e.g., Cline in VS Code) and follow that file's setup snippet end-to-end — verify tts_status round-trips

The first three are quick verification; the fourth is the real smoke test and can land in a follow-up if a tester isn't immediately available.

🤖 Generated with Claude Code

Adds the multi-platform reach for codetalker per SP-4 of the commercial
launch master plan. CodeTalker already ships an MCP server
(claude-code-talker-mcp-stdio) that any MCP-compatible AI agent can
connect to — the work this PR adds is packaging + discoverability:

1. **Shorter console_script alias** in core/pyproject.toml:
   - codetalker-mcp = claude_code_talker.mcp_stdio:main
   - Existing claude-code-talker-mcp-stdio kept for backwards compat.

2. **Per-agent integration docs** in docs/integrations/ covering:
   - Claude Code (canonical), Cursor, Cline (VS Code), Continue.dev,
     Windsurf, Zed, Codex CLI, Goose, Roo Code, Replit Agent,
     AWS Kiro, Google Antigravity
   - Plus v1.x stubs for Aider (bespoke CLI wrapper) and JetBrains AI
     Assistant (bespoke plugin) — these are Pro Plus targets per the
     master plan, scheduled post-launch.

3. **MCP registry submission metadata** in docs/integrations/mcp-registries.md
   — canonical YAML + submission status for the 8 MCP registries:
   - registry.modelcontextprotocol.io (official, Sept 2025)
   - PulseMCP, MCP.so, mcpservers.org
   - GitHub MCP Registry, modelcontextprotocol/servers awesome-list
   - Anthropic Claude Marketplace, Continue Hub

4. **README update** with a 'Use with other AI-coding agents' section
   linking to the new integration guides.

No daemon-side code changes — the existing 9 agent-facing MCP tools
(tts_speak, tts_set_mode, tts_status, tts_mute, tts_unmute,
tts_list_voices, tts_set_voice, tts_set_cadence, tts_shutdown) already
work with any MCP client.

Session-scoped tool variants (narrate with voice/mode args,
session_set_mode, session_set_mute, session_list) ship in a follow-up
PR per the master plan's split-PR strategy.

Refs: docs/superpowers/specs/2026-05-09-cct-30-open-core-strategy.md
Refs: C:/Users/brand/.claude/plans/i-want-to-start-merry-treasure.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@OpenCircuitDev OpenCircuitDev merged commit 01b819c into main May 10, 2026
3 checks passed
@OpenCircuitDev OpenCircuitDev deleted the feat/codetalker-mcp-multiplatform-docs branch May 10, 2026 23:37
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.

1 participant