基本能力
产品定位
mcp-server 是一个开源项目,提供了一系列基于 Model Context Protocol (MCP) 的参考实现,旨在帮助开发者扩展大型语言模型 (LLMs) 的功能,使其能够安全地访问各种工具和数据源。
核心功能
- 多样化工具集成:支持文件系统操作、Git 仓库管理、数据库访问(如 PostgreSQL、SQLite)、浏览器自动化(如 Puppeteer)、位置服务(如 Google Maps)等。
- 安全控制:提供配置化的访问控制,确保 LLMs 只能访问授权的资源和数据。
- 多语言支持:使用 TypeScript 和 Python SDK 实现,方便开发者选择熟悉的语言进行扩展。
- 社区驱动:包含大量第三方和社区开发的服务器,覆盖更多领域和用例。
适用场景
- 开发效率:通过集成 Git、GitHub、GitLab 等工具,提升代码管理和协作效率。
- 数据管理:访问和操作数据库(如 PostgreSQL、Redis),支持数据查询和分析。
- 内容生成:利用 AI 图像生成(如 EverArt)和文档处理工具(如 Pandoc)生成多样化内容。
- 金融服务:集成 Stripe、Adfin 等工具,支持支付和财务操作。
- 位置服务:使用 Google Maps 提供地理位置查询和导航功能。
- 浏览器自动化:通过 Puppeteer 实现网页抓取和自动化测试。
工具列表
- AWS KB Retrieval:从 AWS Knowledge Base 检索数据。
- Brave Search:使用 Brave 搜索 API 进行网页和本地搜索。
- EverArt:基于多种模型的 AI 图像生成。
- Puppeteer:浏览器自动化和网页抓取。
- Google Maps:提供位置服务、路线规划和地点详情。
- PostgreSQL:只读数据库访问和模式检查。
- Slack:频道管理和消息发送。
常见问题解答
- 如何启动服务器? 使用
npx
或uvx
命令启动对应的服务器(如npx -y @modelcontextprotocol/server-memory
)。 - 如何配置 MCP 客户端? 在客户端配置文件中指定服务器命令和参数(如 Claude Desktop 的 JSON 配置)。
- 如何贡献? 参考 CONTRIBUTING.md 提交新的服务器或改进现有代码。
使用教程
使用依赖
- Node.js:用于运行 TypeScript 服务器。
- Python:用于运行 Python 服务器。
- uvx 或 pip:推荐使用
uvx
安装 Python 服务器(如uvx mcp-server-git
)。
安装教程
- 安装 Node.js 或 Python:
```sh
# Node.js (via nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install --lts
# Python (via pyenv)
curl https://pyenv.run | bash
pyenv install 3.11.6
2. **启动服务器**:
sh
# TypeScript 服务器
npx -y @modelcontextprotocol/server-memory
# Python 服务器
uvx mcp-server-git
```
调试方式
- 日志检查:服务器启动时会输出日志,检查是否有错误信息。
- 客户端测试:在 MCP 客户端(如 Claude Desktop)中测试工具是否可用。
- 环境变量:确保必要的环境变量已设置(如
GITHUB_PERSONAL_ACCESS_TOKEN
)。