🚀 创建自定义服务器指南
本指南将指导你构建自己的服务器，用于Claude桌面版和其他客户端。通过本教程，你将学会构建一个简单的MCP计算器服务器，并将其连接到Claude桌面版主机。
✨ 主要特性
- MCP协议扩展：利用模型上下文协议（MCP）扩展Claude等AI助手的功能。
- 自定义工具创建：可以构建各种工具，如天气服务器、计算器、财务管理助手等。
- 多系统支持：支持在MacOS、Linux和Windows系统上创建和配置服务器。
📦 安装指南
先决条件
- 具备基础的Python编程经验。
- 对大型语言模型（LLM）有基本了解。
- 系统要求：
- Python 3.8 或更高版本。
- 参考MCP官方文档：MCP官方文档
创建项目并初始化环境
MacOS/Linux
# 安装uv CLI 工具（如果尚未安装）
brew install model-context-protocol/protobuf/protobuf-cpp
# 初始化新项目
mkdir calculator && cd calculator
Windows
# 安装uv CLI 工具（如果尚未安装）
# 需要从MCP官方网站下载并安装Windows版本的uv工具。
# 初始化新项目
mkdir calculator && cd calculator
💻 使用示例
基础用法
实现代码
以下是实现计算器服务器的完整代码：
# 导入库和模块
from fastapi import FastAPI
from typing import Optional, Union
import uvicorn
# 定义工具
app = FastAPI()
@app.get("/calculate")
async def calculate(
expression: str,
error_handling: Optional[bool] = True,
simplify: Optional[bool] = True
) -> Union[str, dict]:
"""Calculate a mathematical expression."""
try:
result = eval(expression)
if simplify:
return f"{expression} 的结果是 {result}"
return str(result)
except Exception as e:
if error_handling:
return {"error": str(e)}
raise
# 启动服务器
if __name__ == "__main__":
uvicorn.run(app, host="0.0.0.0", port=8000)
配置Claude桌面版
MacOS/Linux
编辑配置文件：
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
将以下内容添加到 mcpServers 键下：
{
"mcpServers": {
"calculator": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/calculator",
"run",
"calculator.py"
]
}
}
}
Windows
编辑配置文件：
code $env:AppData/Claude/claude_desktop_config.json
将以下内容添加到 mcpServers 键下：
{
"mcpServers": {
"calculator": {
"command": "uv",
"args": [
"--directory",
"C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\calculator",
"run",
"calculator.py"
]
}
}
}
⚠️ 重要提示
请确保将
/ABSOLUTE/PATH/TO/PARENT/FOLDER替换为你的实际路径。
保存文件后，重启Claude桌面版，即可在Claude桌面版中使用计算器服务器进行基本的算术运算。
📚 详细文档
什么是MCP？
MCP 即 模型上下文协议，它是一种允许开发者扩展AI助手（如Claude）功能的协议。可以理解为给AI助手 增加额外能力，这些服务器公开工具或功能，助手可以在对话期间使用。例如，你可以构建天气服务器、计算器、财务管理助手，或者任何你能想象的功能。
我们将要构建的内容
我们将构建一个提供四个工具的服务器：add、subtract、multiply 和 divide，然后将该服务器连接到MCP主机（在此示例中为Claude桌面版）。
核心概念
- 资源：允许助手访问外部数据或服务。
- 工具：扩展助手的功能。
- 提示：自定义助手的交互方式。
此次重点放在 工具 上，因为我们将创建一个计算器工具。