Codearchitect MCP

CodeArchitect MCP

你的AI对话不应该消失。 CodeArchitect MCP会自动保存和检索您与AI助手的讨论，为开发人员解决上下文连续性问题。永远不要重新解释架构决策或代码解决方案。基于模型上下文协议（MCP）构建-与游标和VS代码无缝协作。扩展到全面的系统设计和架构协助。

快速开始

1.安装Node.js

下载自 （v18+）。打开终端→ type node --version 以验证。

2.安装软件包

npm install -g codearchitect-mcp

3.配置IDE

📘 Cursor Users - Complete Setup Guide

步骤1：打开光标设置

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

步骤2：查找MCP设置

1. 在顶部的“设置”搜索框中，键入： “MCP” 或 “模型上下文协议”
2. 你应该看看 “工具和MCP” 章节
3. 点击它

步骤3：添加CodeArchitect服务器

1. 寻找 “MCP服务器” 或 “添加服务器” 按钮
2. 点击 “添加服务器” 或 + 按钮
3. 将出现一个表单。填写：

- 名字: codearchitect （或任何你喜欢的名字） - 命令: npx - 参数: -y codearchitect-mcp@latest

1. 点击 保存 或 好的

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

1. 关闭光标
2. 打开文件资源管理器（Windows）或Finder（Mac）
3. 转到您的主文件夹：

- 视窗: C:\Users\YourName\.cursor\ （创建 .cursor 文件夹（如果不存在） - Mac/Linux: ~/.cursor/ （创建 .cursor 文件夹（如果不存在）

1. 创建一个名为的文件 mcp.json 在该文件夹中
2. 在任何文本编辑器中打开它并粘贴以下内容：

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

1. 保存文件
2. 再次打开光标

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

1. 在Cursor中，查看底部状态栏
2. 你应该看看 “MCP” 或 “代码架构师” 带绿点（连接）
3. 如果您看到红色或黄色，则表示出了问题-请参阅下面的故障排除

步骤5：重新加载光标

1. 按 Ctrl+Shift+P （Windows/Linux）或 Cmd+Shift+P （Mac）
2. 类型： “重新加载窗口”
3. 按Enter键
4. 游标将重新启动-等待它完成加载

步骤6：测试它是否有效

1. 在Cursor中打开任何聊天/对话
2. 类型： “使用代码架构师”
3. 您应该看到功能列表和工作流程指南
4. 如果您看到错误，请参阅下面的故障排除

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

1. 在Cursor聊天中，查看右上角
2. 点击 三个点 菜单（⋯）
3. 点击 “导出聊天”
4. 出现保存对话框
5. 导航到： C:\Users\YourName\.codearchitect\exports\ （Windows）或 ~/.codearchitect/exports/ （Mac/Linux）

- 创建 exports 文件夹（如果不存在）

1. 点击 保存
2. 文件将另存为 .md 格式（这很正常）

需要帮助？

任何一步都卡住了吗？ 联系Tair：

• 电子邮件：查看GitHub个人资料以获取联系方式
• GitHub问题:
• 说出你正在进行的步骤和正在发生的事情

📘 VS Code Users - Complete Setup Guide

步骤1：打开命令面板

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

步骤2：添加MCP服务器

1. 在“命令选项板”框中，键入： “MCP:添加服务器”
2. 你应该看看 “MCP:添加服务器…” 出现在列表中
3. 单击它（或按Enter键）

步骤3：选择安装方法

1. 出现一个菜单，询问如何安装
2. 选择： “使用npm包下载” （点击它）
3. 出现另一个框，要求输入包名称

步骤4：输入包名称

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

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

1. 查看VS Code的右下角
2. 你应该看看 “MCP” 或 “代码架构师” 带绿色指示灯（已连接）
3. 如果您看到红色或错误，请参阅下面的故障排除

步骤6：重新加载VS代码

1. 按 Ctrl+Shift+P （Windows/Linux）或 Cmd+Shift+P （Mac）再次
2. 类型： “开发人员：重新加载窗口”
3. 按Enter键
4. VS Code将重新启动-等待它完成

步骤7：测试它是否有效

1. 在VS Code中打开任何聊天/对话
2. 类型： “使用代码架构师”
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会自动添加）

1. 导航到： C:\Users\YourName\.codearchitect\exports\ （Windows）或 ~/.codearchitect/exports/ （Mac/Linux）

- 创建 exports 文件夹（如果不存在）

1. 点击 保存
2. 文件将另存为 .json 格式（这很正常，CodeArchitect支持！）

需要帮助？

任何一步都卡住了吗？ 联系Tair：

• 电子邮件：查看GitHub个人资料以获取联系方式
• GitHub问题:
• 说出你正在进行的步骤和正在发生的事情

4.验证设置

• 检查MCP状态：IDE中应显示绿色/已连接
• 测试：说 "use codearchitect" -应该看到功能列表
• 如果不工作：重新加载IDE并检查MCP日志/联系Tair

5.开始使用

• "use codearchitect" -请参阅功能和工作流程指南
• "use codearchitect store_session" -保存对话
• "use codearchitect get_session" -检索会话
• "use codearchitect search_session [query]" -在所有会话中搜索

存储

主要位置: ~/.codearchitect/sessions/ （总是）

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

可选的：同时保存到项目文件夹（指定 projectDir)

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

工作流程

1. 导出聊天 → 保存到 ~/.codearchitect/exports/
2. 商店会话 → "use codearchitect store_session"
3. 检索 → "use codearchitect get_session [topic]"
4. 搜索 → "use codearchitect search_session [query]" -按关键字查找会话
5. 重复 → 迭代构建知识库

文档

• API -工具参考
• 常见问题解答 -常见问题
• 入职 -安装指南
• 故障排除 -解决问题

链接

• 文档: codearchitect.mintlify.app
• npm: 代码架构师mcp
• GitHub: tairqaldy/代码架构师mcp

______________________________________________________________________

由...制作❤️ 通过 塔尔·卡尔德巴耶夫