用途
MCP Server Toolkit 解决 AI 编程助手在真实代码库中“要么读遍所有文件、要么凭前几个文件猜测”的问题。它通过 Model Context Protocol 标准，为 AI 代理提供直接查询代码、文档、数据库与 API 的工具，无需修改现有代码，任何兼容 MCP 的客户端均可使用。
主要能力
- 语义代码搜索：基于向量嵌入，在整个仓库中毫秒级定位函数、文件或模式，无需 Elasticsearch。
- 文档服务器：让代理即时访问任意文档站点、本地 Markdown 文件或 Notion 工作区。
- 数据库服务器：支持 PostgreSQL、MySQL、SQLite 的自然语言转 SQL；默认只读，需显式标志才可写入。
- API 内省服务器：加载任意 OpenAPI/Swagger 规范，让代理浏览并以类型安全方式调用端点。
- 持久化项目记忆（mcp-memory）：跨 AI 编程会话记住架构决策、模式、约束与项目约定。
- 一键安装：每个服务器均为独立 CLI，提供 npx 与 pip 安装路径。
- 零配置密钥：从现有 .env 文件或环境变量读取，无需学习新方式。
- 广泛兼容：Claude Code、Cursor、Windsurf、Cline、VS Code Copilot、Codex CLI、Gemini CLI 等 MCP 兼容客户端。
- 可扩展：createServer() 辅助函数可将新工具缩减到约 15 行 TypeScript，30 秒内搭建自定义服务器。
使用方式
环境要求：Node.js 18+ 或 Python 3.10+。 安装选项：
- 选项 A — npx（免安装）：运行交互式设置向导，选择服务器、粘贴凭据，生成可直接粘贴到 Claude Code / Cursor 的配置块。
- 选项 B — npm 全局安装。
- 选项 C — pip（Python 环境）。 接入 Claude Code：执行 mcp init 后，将生成的配置块复制到 .claude/mcp.json，重启 Claude Code 即可使用。 安装后，AI 代理可用自然语言与整个开发环境交互，无需复制粘贴或切换上下文。
适用场景
- 在大型代码库中快速定位 Stripe webhook 等具体逻辑。
- 让 AI 代理查询数据库而不必手动写 SQL。
- 为代理提供项目文档、Notion 或本地 Markdown 的即时检索。
- 基于 OpenAPI 规范浏览和调用 API。
- 跨会话保留架构决策与项目约定。
限制与安全
- 所有服务器默认只读，写入需显式 --writable 标志。
- 凭据仅从环境变量读取，绝不硬编码或记录日志。
- shell 服务器使用允许列表（mcp-shell.config.json），不执行任意命令。
- 发现漏洞应发送邮件至 security@naveenayalla1-CS50.dev，而非公开 issue。
- 许可证为 MIT © 2026 naveenayalla1-CS50。
项目结构（部分）
包含代码搜索（语义 + 关键词）、PostgreSQL / MySQL / SQLite 服务器、文档服务器（Markdown + URL 抓取）、OpenAPI 内省服务器等。路线图提及 Linear / Jira 服务器、Supabase + PlanetScale 托管数据库支持、浏览已注册工具的 Web UI、从 schema 自动生成工具描述等，具体实现状态暂未提供。
