<基本原则> 每个 MCP 服务器必须遵循以下规则： 1. **永远不要对秘密进行硬编码** \- 在代码中的配置、环境变量中使用 `${VAR}` 扩展 2. **使用`cwd`属性** \- 隔离依赖关系（不是args中的`--cwd`） 3. **始终使用绝对路径** \- `which uv` 来查找路径，从不相对 4. **每个目录一台服务器** \- `~/Developer/mcp/{server-name}/` 5. **对 Python 使用`uv`** \- 比 pip 更好，自动处理 venvs <安全检查表> * 永远不要要求用户将秘密粘贴到聊天中 * 始终使用环境变量作为凭据 * 在配置中使用 ${VAR} 扩展 * 为用户在终端中运行提供准确的命令 * 验证环境变量是否存在而不显示值 * 切勿在代码或配置中硬编码 API 密钥操作数决定架构： * **1-2 次操作** → 传统图案（平面工具） * **3+ 操作** → 按需发现模式（元工具）传统：每个操作都是一个单独的工具按需：4 个元工具（discover、get_schema、execute、 continue）+ Operations.json 标准位置：`~/Developer/mcp/{server-name}/` **未提供上下文**（在没有描述的情况下调用技能）：使用 AskUserQuestion： * 标题：“模式” *问题：“你想做什么？” * 选项： *“创建新的MCP服务器”→workflows/create-new-server.md *“更新现有的MCP服务器”→workflows/update-existing-server.md *“服务器故障排除”→workflows/troubleshoot-server.md **提供上下文**（用户描述了他们想要的内容）：直接路由到工作流程/create-new-server.md <工作流程索引> 工作流程|目的 ---|--- 创建新服务器.md |从接收到验证的完整 8 步工作流程更新现有服务器.md |修改或扩展现有服务器故障排除服务器.md |诊断并修复连接/运行时问题 | <模板索引> 模板|目的 ---|--- python-server.py | Python 的传统模式启动器打字稿服务器.ts | TypeScript 的传统模式启动器操作.json |按需发现操作定义 | <脚本索引> 脚本 |目的 ---|--- 设置-python-project.sh |使用uv初始化Python MCP项目设置-typescript-project.sh |使用 npm 初始化 TypeScript MCP 项目 | **核心工作流程：** *creation-workflow.md - 使用精确命令完成分步操作 **架构模式：** *传统-pattern.md - 用于 1-2 次操作（平面工具） * large-api-pattern.md - 用于 3 个以上操作（按需发现） **特定语言：** * python-implementation.md - 异步模式，类型提示 * typescript-implementation.md - 类型安全、SDK 功能 **高级主题：** * oauth-implementation.md - 具有 stdio 隔离的 OAuth *response-optimization.md - 字段截断、分页 * tools-and-resources.md - 资源 API、提示、流 *testing-and-deployment.md - 单元测试、打包、发布 *validation-checkpoints.md - 所有验证检查 * Adaptive-questioning-guide.md - 摄入问题模板 * api-research-template.md - API研究文档格式 <快速参考> # 列出服务器克劳德·MCP名单 # 添加服务器（Python） claude mcp add --transport stdio <名称> \ --env API_KEY='${API_KEY}' \ -- uv --directory ~/Developer/mcp/<名称> 运行 python -m src.server # 添加服务器（TypeScript） claude mcp add --transport stdio <名称> \ --env API_KEY='${API_KEY}' \ -- 节点 ~/Developer/mcp/<名称>/build/index.js # 删除服务器克劳德·MCP 删除 <名称> # 检查日志 tail -f ~/Library/Logs/Claude/mcp-server-<名称>.log # 查找路径哪个 uv && 哪个节点 && 哪个 python **服务器未出现：** 检查“claude mcp list”，验证“~/.claude/settings.json”中的配置 **“未找到命令”：**使用`which uv`/`which node`的绝对路径 **未找到环境变量：** echo $MY_API_KEY # 检查是否设置 echo 'export MY_API_KEY="value"' >> ~/.zshrc && 源 ~/.zshrc **对话中可见的秘密：** 停止。删除对话。轮换凭证。切勿在聊天中粘贴秘密。完整的故障排除：workflows/troubleshoot-server.md 生产就绪的 MCP 服务器具有： * Claude 代码中的有效配置（`claude mcp list` 显示 ✓ 已连接） * Claude Desktop 配置中的有效配置 * 在 ~/.zshrc 中安全设置环境变量 * 架构与操作数相匹配 * OAuth stdio 隔离（如果适用） * 列表/搜索操作的响应优化 * 所有验证检查点均已通过 * 日志中没有错误

创建 Mcp 服务器

包含技能