自定义MCP服务器实现

自定义MCP服务器实现

一个为Claude Desktop等LLM客户端提供文件系统和命令执行工具的Model Context Protocol (MCP) 服务器。

快速入门

前置条件

  • Python 3.10 或更高版本
  • 支持MCP协议的客户端(如Claude Desktop)

安装

  1. 安装uv工具:uv安装指南
  2. 克隆本仓库或下载源码。
  3. 执行 uv run mcp install 安装MCP服务器。
  4. 使用 which uv 获取 uv 可执行文件的绝对路径。
  5. 更新Claude Desktop中的MCP配置,设置为上述路径。

配置示例

{
  "globalShortcut": "",
  "mcpServers": {
    "zbigniew-mcp": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/server.py"
      ]
    }
  }
}

使用

  1. 在Claude Desktop中连接到标识符为 zbigniew-mcp 的MCP服务器。
  2. 使用提供的工具(如执行命令、读取文件等)扩展LLM能力。

示例工具

  • execute_shell_command: 执行Shell命令
  • show_file: 查看文件内容
  • edit_file: 编辑文件
  • write_file: 写入文件

更多功能详见README文档。