使用说明
我的MCP服务器
演示核心功能的基本MCP(模型上下文协议)服务器模板。
特性
工具
- 回声 -回显消息(对测试有用)
- 计算 -执行基本的数学运算(加、减、乘、除)
- 获取信息 -返回有关服务器的信息
资源
- resource://examples/welcome -新用户欢迎信息
- resource://examples/capabilities -服务器功能的JSON描述
安装
- 安装依赖项:
pip install -r requirements.txt
- 在本地测试服务器:
python my_serv.py
配置
添加到光标
将此服务器添加到您的游标 mcp.json 文件:
{
"mcpServers": {
"my-mcp-server": {
"command": "python",
"args": ["/Users/fpj/Development/python/mcp/my_serv.py"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
配置选项
您可以添加环境变量来自定义行为:
"env": {
"LOG_LEVEL": "DEBUG",
"CUSTOM_VAR": "value"
}
发展
项目结构
mcp/
├── my_serv.py # Main server implementation
├── requirements.txt # Python dependencies
└── README.md # This file
添加新工具
要添加新工具,请执行以下操作:
- 将工具定义添加到
list_tools():
Tool(
name="my_tool",
description="Description of what it does",
inputSchema={
"type": "object",
"properties": {
"param": {"type": "string"}
},
"required": ["param"]
}
)
- 在中添加工具处理程序
call_tool():
elif name == "my_tool":
param = arguments.get("param")
# Your logic here
return [TextContent(type="text", text=f"Result: {param}")]
添加资源
要添加新资源,请执行以下操作:
- 增添
list_resources():
Resource(
uri="resource://my/resource",
name="Resource Name",
mimeType="text/plain",
description="What this resource provides"
)
- 在中添加处理程序
read_resource():
elif uri == "resource://my/resource":
return "Resource content here"
游标中的用法
将服务器添加到您的 mcp.json 并重新启动Cursor:
- 在Cursor中打开任何文件
- 在聊天中,您现在可以使用以下命令:
- “使用回声工具打招呼”
- “计算15+27”
- “显示服务器功能”
AI会自动调用您的MCP服务器工具!
调试
查看日志
日志被写入stderr。在光标中:
- 首选 View → 输出
- 从下拉列表中选择您的服务器
- 查看实时日志
常见问题
服务器未启动:
- 检查是否安装了Python 3.8+
- 验证是否安装了依赖项:
pip install -r requirements.txt - 检查路径
mcp.json是正确的
工具不可用:
- 重新启动光标(Cmd/Ctrl+Shift+P→ “开发人员:重新加载窗口”)
- 检查输出面板是否有错误消息
- 验证
mcp.json语法有效
工具执行过程中出错:
- 检查输出面板是否有堆栈痕迹
- 确保您的工具逻辑能够处理边缘情况
- 验证输入参数是否与架构匹配
后续步骤
扩展此服务器的想法
-
文件系统操作
- 读/写文件
- 搜索目录
- 文件管理
-
API集成
- 连接到外部服务
- 从API获取数据
- 发送通知
-
数据库访问
- 查询数据库
- 执行SQL
- 数据分析
-
自定义工作流
- 自动化重复性任务
- 代码生成
- 项目脚手架
-
系统操作
- 运行shell命令
- 过程监控
- 环境管理
资源
许可证
麻省理工学院
