使用说明
如何构建MCP服务器-计算器示例
关于
这是一个非常简单的示例,说明如何构建一个向MCP客户端提供基本数学运算的MCP服务器。
什么是MCP?
模型上下文协议(MCP)是一种使LLM能够访问自定义工具和服务的协议。MCP客户端可以向MCP服务器发出请求,以访问它们提供的工具。此示例表示一个向客户端提供基本数学运算的简单计算器服务器。
“MCP可以为人工智能模型与外部系统交互提供一种单一的标准化方式。你只需编写一次代码,所有人工智能系统都可以使用它。” 1
“服务器是用外部数据和上下文丰富LLM的基本构建块。” 2
技术栈
- Python 3
- Pytest
- MCP-SDK
- MCP-CLI
- Nix(可选)
如何设置和使用
史密瑟里
通过以下方式自动安装Claude Desktop的mcp服务器计算器 史密瑟里:
npx -y @smithery/cli install @simonberner/mcp-server-calculator --client claude
开发设置
由于我们在这个项目中使用Nix是为了拥有一个可重复和隔离的开发环境,因此不需要安装Python或任何其他依赖项。你会从盒子里得到你需要的一切。此外,也不需要使用Python创建虚拟环境 venv 或 poetry,但您必须愿意在系统上安装Nix。
替代
如果你不想走Smithery或Nix路线,你当然也可以使用 紫外线 构建包/项目。以下是一些指导:
# Install uv (see https://docs.astral.sh/uv/getting-started/installation/)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create a virtual environment named .venv
uv venv
# Activate the virtual environment (example for bash/zsh)
source .venv/bin/activate
# Now run the install or build commands
uv pip install -e .
# or
uv pip wheel . -w dist
在本地运行和测试服务器
- MCP检查员 是一个方便的GUI工具,允许您通过web界面测试自定义MCP服务器http://localhost:5173而无需将其与LLM/AI代理集成。
mcp dev src/mcp_server_calculator/calculator.py
主机/客户端集成
- 将以下内容添加到您的mcp配置中:
{
"mcpServers": {
"calculator": {
"command": "python",
"args": [
"<YOUR-PATH>/mcp-server-calculator/src/mcp_server_calculator/calculator.py"
]
}
}
}
备注
- 使用时 Windsurf IDE 作为MCP主机,您需要 专业计划 能够将Cascade(作为MCP客户端)与MCP服务器一起使用。
问题
检查 问题 查看当前问题或打开新问题。
资源
- [1] MCP服务器:从头开始构建的分步指南
- [2] 什么是模型上下文协议(MCP)?
- 了解MCP以及人工智能工程师如何利用它
- MCP-SDK
- MCP-CLI
- MCP检查员
- 最大的MCP服务器集合
- MCP使用入门指南
- Claude MCP永远改变了人工智能-这是你需要知道的
- 查找MCP服务器
- 在10分钟内使用TypeScript构建您的第一个MCP服务器
- 模型上下文协议(MCP)介绍
鸣谢
- Nix设置取自 ical2json
