概述
本指南将带您快速构建一个简单的 MCP 服务器,让您了解 Model Context Protocol 的基本工作原理。前提条件:
- Python 3.8+ 或 Node.js 18+
- 对 JSON-RPC 有基本了解(可选)
选择开发语言
MCP 支持多种编程语言。选择您熟悉的语言开始:Python 实现
第 1 步:安装 SDK
第 2 步:创建基本服务器
创建一个名为mcp_server.py
的文件:
第 3 步:运行服务器
TypeScript 实现
第 1 步:安装 SDK
第 2 步:创建基本服务器
创建一个名为server.ts
的文件:
第 3 步:运行服务器
测试您的服务器
使用 Claude Desktop 测试
- 打开 Claude Desktop 应用
- 在设置中配置您的 MCP 服务器:
- 重启 Claude Desktop
- 在对话中尝试:
@greeting/Alice
- 获取问候资源- 要求计算
2 + 2
- 使用计算工具
使用命令行测试
您也可以使用 MCP Inspector 工具:下一步
恭喜!您已经创建了第一个 MCP 服务器。接下来可以:故障排除
服务器无法启动
服务器无法启动
检查:
- Python/Node.js 版本是否符合要求
- 依赖是否正确安装
- 端口是否被占用
Claude Desktop 无法连接
Claude Desktop 无法连接
确保:
- 配置文件格式正确
- 文件路径正确
- 重启了 Claude Desktop
工具调用失败
工具调用失败
验证:
- 工具参数定义正确
- 函数实现没有错误
- 返回值格式符合规范