CodeArchitect MCP

你的AI对话不应消失。 CodeArchitect MCP 自动保存并检索你与AI助手的讨论，解决了开发者上下文连续性的问题。无需重复解释架构决策或代码解决方案。基于模型上下文协议（MCP）构建，与Cursor和VS Code无缝集成。扩展到全面的系统设计和架构辅助。

快速开始

1. 安装Node.js

从nodejs.org下载（v18+）。打开终端 → 输入 node --version 验证。

2. 安装包

npm install -g codearchitect-mcp

3. 配置IDE

<details> <summary><b>📘 Cursor用户 - 完整设置指南</b></summary>

步骤1：打开Cursor设置

1. 打开Cursor（代码编辑器）
2. 查看左下角 - 点击齿轮图标 ⚙️（或在Windows/Linux上按 Ctrl+,，在Mac上按 Cmd+,）
3. 这将打开设置

步骤2：查找MCP设置

1. 在顶部的设置搜索框中输入：“MCP” 或 “模型上下文协议”
2. 应该能看到“工具及MCP”部分
3. 点击它

步骤3：添加CodeArchitect服务器

1. 查找“MCP服务器”或“添加服务器”按钮
2. 点击“添加服务器”或“+”按钮
3. 将出现一个表单。填写如下内容：
   • 名称：codearchitect（或你喜欢的任何名称）
   • 命令：npx
   • 参数：-y codearchitect-mcp@latest
4. 点击保存或确定

或者（替代方法 - 手动配置文件）：

1. 关闭Cursor
2. 打开文件资源管理器（Windows）或Finder（Mac）
3. 转到您的主文件夹：
   • Windows：C:\Users\YourName\.cursor\（如果不存在，请创建.cursor文件夹）
   • Mac/Linux：~/.cursor/（如果不存在，请创建.cursor文件夹）
4. 在该文件夹中创建名为mcp.json的文件
5. 使用任何文本编辑器打开它，并粘贴以下内容：

{
  "mcpServers": {
    "codearchitect": {
      "command": "npx",
      "args": ["-y", "codearchitect-mcp@latest"]
    }
  }
}

6. 保存文件
7. 再次打开Cursor

步骤4：验证是否正常工作

1. 在Cursor底部的状态栏查看
2. 应该看到“MCP”或“codearchitect”带有绿色点（连接状态）
3. 如果看到红色或黄色，则出现问题 - 参见下方故障排除

步骤5：重新加载Cursor

1. 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）
2. 输入：“重载窗口”
3. 按回车键
4. Cursor将重启 - 等待其完成加载

步骤6：测试是否正常工作

1. 在Cursor中打开任何聊天/对话
2. 输入：“使用codearchitect”
3. 应该看到功能列表和工作流程指南
4. 如果看到错误，请参见下方故障排除

导出聊天（如何保存对话）

1. 在Cursor聊天中，查看右上角
2. 点击三个点菜单（⋯）
3. 点击“导出聊天”
4. 出现保存对话框
5. 导航至：C:\Users\YourName\.codearchitect\exports\（Windows）或~/.codearchitect/exports/（Mac/Linux）
   • 如果不存在，请创建exports文件夹
6. 点击“保存”
7. 文件将以.md格式保存（这是正常的）

需要帮助？

卡在任何步骤了吗？ 联系Tair：

• 电子邮件：查看GitHub个人资料获取联系方式
• GitHub问题：github.com/tairqaldy/codearchitect-mcp/issues
• 提及您所在步骤以及遇到的情况

</details> <details> <summary><b>📘 VS Code用户 - 完整设置指南</b></summary>

步骤1：打开命令面板

1. 打开VS Code（Visual Studio Code）
2. 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）
3. 顶部会出现一个框 - 这是命令面板

步骤2：添加MCP服务器

1. 在命令面板框中输入：“MCP: 添加服务器”
2. 应该能看到“MCP: 添加服务器...”出现在列表中
3. 点击它（或按回车键）

步骤3：选择安装方式

1. 出现一个菜单询问如何安装
2. 选择：“通过npm包下载”（点击它）
3. 另一个框会询问包名

步骤4：输入包名

1. 精确输入：codearchitect-mcp
2. 按回车键
3. VS Code将下载并安装它（等待几秒钟）

步骤5：验证是否正常工作

1. 查看VS Code右下角
2. 应该看到“MCP”或“codearchitect”带有绿色指示符（连接状态）
3. 如果看到红色或错误，请参见下方故障排除

步骤6：重新加载VS Code

1. 再次按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）
2. 输入：“开发者：重载窗口”
3. 按回车键
4. VS Code将重启 - �等待其完成加载

步骤7：测试是否正常工作

1. 在VS Code中打开任何聊天/对话
2. 输入：“使用codearchitect”
3. 应该看到功能列表和工作流程指南
4. 如果看到错误，请参见下方故障排除

导出聊天（如何保存对话）

1. 在VS Code聊天中，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）
2. 输入：“导出聊天”
3. 从列表中点击“导出聊天”
4. 出现保存对话框
5. 重要：给文件命名有意义的内容，如：
   • auth-implementation.json
   • database-design.json
   • api-routes.json
   • （使用.json作为结尾 - VS Code会自动添加）
6. 导航至：C:\Users\YourName\.codearchitect\exports\（Windows）或~/.codearchitect/exports/（Mac/Linux）
   • 如果不存在，请创建exports文件夹
7. 点击“保存”
8. 文件将以.json格式保存（这是正常的 - CodeArchitect支持这种格式！）

需要帮助？

卡在任何步骤了吗？ 联系Tair：

• 电子邮件：查看GitHub个人资料获取联系方式
• GitHub问题：[github.com/tairqaldy/codearchitect-mcp/issues](https://github.com/t tairqaldy/codearchitect-mcp/issues)
• 提及您所在步骤以及遇到的情况

</details>

4. 验证设置

• 检查MCP状态：应在IDE中显示绿色/已连接
• 测试：输入 "使用codearchitect" - 应看到功能列表
• 如果未正常工作：重新加载IDE并检查MCP日志 / 联系Tair

5. 开始使用

• "使用codearchitect" - 查看功能和工作流程指南
• "使用codearchitect存储会话" - 保存对话
• "使用codearchitect获取会话" - 检索会话

存储

主要位置：~/.codearchitect/sessions/（始终）

• Windows：C:\Users\YourName\.codearchitect\sessions\
• Linux/Mac：~/.codearchitect/sessions/

可选：也保存到项目文件夹（指定projectDir）

导出：~/.codearchitect/exports/（用于检测导出文件）

工作流

1. 导出聊天 → 保存到 ~/.codearchitect/exports/
2. 存储会话 → "使用codearchitect存储会话"
3. 检索 → "使用codearchitect获取会话 [主题]"
4. 重复 → 迭代构建知识库

文档

• API - 工具参考
• 常见问题 - 常见问题
• 入门指南 - 设置指南
• 故障排除 - 解决问题

链接

• 文档：codearchitect.mintlify.app
• npm：codearchitect-mcp
• GitHub：tairqaldy/codearchitect-mcp

---

由Tair Kaldybayev精心制作 ❤️