Thinking Partner MCP

思考伙伴 MCP

一个 Model Context Protocol（MCP）服务，可在 Claude Desktop 和 Claude Code 之间创建统一的 AI 思考伙伴。这让架构思考与实现工作之间能够无缝共享上下文并保持对话连贯性。

快速入门

# Install dependencies
npm install

# Test the server
npm test

# Configure Claude Desktop
npm run setup-desktop

# Configure Claude Code  
npm run setup-code

# Start development server
npm run dev

神奇的工作流

上午设计会议（Claude Desktop）

1. 设定重点：「我正在设计身份验证系统」
2. 架构讨论：探索方案并做出决策
3. 自动记录：记录设计决策及其理由

实现阶段（Claude Code）

1. 自动获取上下文：代码工具了解你的架构决策
2. 发现实现问题：编码时记录发现
3. 反馈循环：实现过程中的见解为后续设计提供参考

次日（任一工具）

• 完整延续：两个工具都记得你的推理过程
• 问题串联：未解决的问题可延续到后续会话
• 模式识别：逐步积累长期知识

可用工具

set_focus

设置你当前正在处理的事项，并在两个工具之间共享

{
  "topic": "user authentication refactor",
  "context": "exploring JWT vs sessions",
  "tool": "desktop"
}

get_context

获取与当前对话相关的上下文

{
  "tool": "code",
  "scope": "current"
}

log_design_decision

记录在 Desktop 中做出的架构决策

{
  "decision": "Use JWT with refresh tokens",
  "reasoning": "Better for distributed architecture",
  "alternatives": ["session cookies", "OAuth only"]
}

log_implementation_finding

记录编码过程中发现的问题

{
  "finding": "JWT library requires specific token structure",
  "code_context": "auth/token.js - jwt.sign() options"
}

bridge_conversation

连接 Desktop 和 Code 之间的对话

{
  "from_tool": "desktop",
  "to_tool": "code", 
  "summary": "Decided on JWT approach",
  "open_questions": ["How to handle token rotation?"]
}

项目结构

thinking-partner-mcp/
├── src/
│   ├── index.js          # Main MCP server
│   ├── storage.js        # JSON persistence layer  
│   └── tools.js          # Tool implementations
├── scripts/
│   ├── setup-desktop.js  # Claude Desktop config
│   ├── setup-code.js     # Claude Code config
│   └── test-server.js    # Server testing
├── data/
│   └── context.json      # Persistent context storage
└── package.json

配置

设置脚本会自动配置 Claude Desktop 和 Claude Code，以使用此 MCP 服务。服务在本地运行，并在 data/context.json 中持久保存上下文。

Git 同步配置

服务支持自动 Git 同步，可在多台机器之间共享上下文：

# Copy example environment file
cp .env.example .env

# Edit .env to add your Git repository
[email protected]:yourusername/thinking-partner-data.git

环境变量：

• THINKING_PARTNER_GIT_SYNC：启用或禁用 Git 同步（默认：true）
• THINKING_PARTNER_AUTO_SYNC：启用或禁用保存时自动同步（默认：true）
• THINKING_PARTNER_GIT_REMOTE：用于同步数据的 Git 仓库 URL

服务将自动：

• 在数据目录中初始化 Git 仓库
• 读取上下文数据前先拉取
• 保存更改后提交并推送
• 通过保留最新数据来处理合并冲突

使用示例

Desktop 会话：

User: "I'm designing a new API authentication system"
Claude: *sets focus and begins architectural discussion*
User: "Let's go with JWT tokens"
Claude: *logs decision with reasoning*

Code 会话：

$ claude-code
Claude: "I see you're implementing the JWT auth system we designed. 
        The decision was based on distributed architecture needs..."
User: "I'm having trouble with token refresh"
Claude: *implementation-focused help*
*logs discovery about refresh token complexity*

次日 Desktop 会话：

Claude: "I notice from your implementation work that JWT refresh 
        tokens were more complex than expected. Should we 
        reconsider the architectural approach?"

基础理念

此工具创建了一种全新的协作思考模式，让 AI 成为你反思过程的延伸。你不再进行彼此孤立的工具交互，而是展开持续的对话，随着时间推移不断加深理解。

真正的力量不在于单项功能，而在于持续使用过程中逐渐形成的认知伙伴关系。

开发

# Start with file watching
npm run dev

# Test the server 
npm test

# View current context
cat data/context.json | jq .

扩展

模块化设计让你可以轻松添加新工具、资源，或集成其他 AI 平台。随着上下文不断增长，还可以增强存储层，以支持更强大的持久化或搜索功能。