模型上下文协议服务器

一个基础的MCP服务器模板,提供回声测试、数学计算和服务器信息获取等核心功能,适用于开发者在Cursor中扩展工具和资源。

  • by fpjrh
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 fpjrh/mcp-test

使用说明

我的MCP服务器

演示核心功能的基本MCP(模型上下文协议)服务器模板。

特性

工具

  • 回声 -回显消息(对测试有用)
  • 计算 -执行基本的数学运算(加、减、乘、除)
  • 获取信息 -返回有关服务器的信息

资源

  • resource://examples/welcome -新用户欢迎信息
  • resource://examples/capabilities -服务器功能的JSON描述

安装

  1. 安装依赖项:
pip install -r requirements.txt
  1. 在本地测试服务器:
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

添加新工具

要添加新工具,请执行以下操作:

  1. 将工具定义添加到 list_tools():
Tool(
    name="my_tool",
    description="Description of what it does",
    inputSchema={
        "type": "object",
        "properties": {
            "param": {"type": "string"}
        },
        "required": ["param"]
    }
)
  1. 在中添加工具处理程序 call_tool():
elif name == "my_tool":
    param = arguments.get("param")
    # Your logic here
    return [TextContent(type="text", text=f"Result: {param}")]

添加资源

要添加新资源,请执行以下操作:

  1. 增添 list_resources():
Resource(
    uri="resource://my/resource",
    name="Resource Name",
    mimeType="text/plain",
    description="What this resource provides"
)
  1. 在中添加处理程序 read_resource():
elif uri == "resource://my/resource":
    return "Resource content here"

游标中的用法

将服务器添加到您的 mcp.json 并重新启动Cursor:

  1. 在Cursor中打开任何文件
  2. 在聊天中,您现在可以使用以下命令:
    • “使用回声工具打招呼”
    • “计算15+27”
    • “显示服务器功能”

AI会自动调用您的MCP服务器工具!

调试

查看日志

日志被写入stderr。在光标中:

  1. 首选 View → 输出
  2. 从下拉列表中选择您的服务器
  3. 查看实时日志

常见问题

服务器未启动:

  • 检查是否安装了Python 3.8+
  • 验证是否安装了依赖项: pip install -r requirements.txt
  • 检查路径 mcp.json 是正确的

工具不可用:

  • 重新启动光标(Cmd/Ctrl+Shift+P→ “开发人员:重新加载窗口”)
  • 检查输出面板是否有错误消息
  • 验证 mcp.json 语法有效

工具执行过程中出错:

  • 检查输出面板是否有堆栈痕迹
  • 确保您的工具逻辑能够处理边缘情况
  • 验证输入参数是否与架构匹配

后续步骤

扩展此服务器的想法

  1. 文件系统操作

    • 读/写文件
    • 搜索目录
    • 文件管理
  2. API集成

    • 连接到外部服务
    • 从API获取数据
    • 发送通知
  3. 数据库访问

    • 查询数据库
    • 执行SQL
    • 数据分析
  4. 自定义工作流

    • 自动化重复性任务
    • 代码生成
    • 项目脚手架
  5. 系统操作

    • 运行shell命令
    • 过程监控
    • 环境管理

资源

许可证

麻省理工学院