本指南旨在帮助您快速上手使用 MCP 服务器,涵盖了不同语言服务器的运行方法、客户端配置示例,以及创建服务器、贡献项目、安全相关等方面的内容。
本仓库提供了基于 TypeScript 和 Python 的 MCP 服务器,下面为您详细介绍运行方法。
基于 TypeScript 的服务器可以直接使用 npx
运行。
例如,运行 Memory 服务器:
npx -y @modelcontextprotocol/server-memory
基于 Python 的服务器可以使用 uvx
或 pip
运行。为简化安装和配置,推荐使用 uvx
。
例如,运行 Git 服务器:
# 使用 uvx
uvx mcp-server-git
# 使用 pip
pip install mcp-server-git
python -m mcp_server_git
⚠️ 重要提示
请按照 这些 指南安装 uv
/ uvx
,以及 这些 安装 pip
。
单独运行一个服务器的作用有限,通常需要将其配置到 MCP 客户端中。以下是将上述服务器集成到 Claude Desktop 中的配置示例:
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}
其他使用 Claude Desktop 作为 MCP 客户端的示例如下:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
},
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "path/to/git/repo"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": ""
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
}
}
}
如果您有兴趣创建自己的 MCP 服务器,请访问官方文档 modelcontextprotocol.io 查看详细指南、最佳实践和技术细节。
有关如何为本仓库做出贡献的信息,请参阅 CONTRIBUTING.md。
有关报告安全漏洞的信息,请参阅 SECURITY.md。
此项目根据 MIT 许可证发布 - 请查看 LICENSE 文件以获取详细信息。
您可以通过 GitHub Discussions 参与社区交流。
如果您发现 MCP 服务器有用,请考虑为仓库加星,并关注我们。