我的MCP服务器

Name: 我的MCP服务器
Author: ZbigniewTomanek

作者：ZbigniewTomanek24 星标更新：2025-04-16

安装使用来源：spider==github.com

项目介绍

MCP工具

一个自定义的模型上下文协议（MCP）服务器实现，提供文件系统和命令执行工具给Claude桌面和其他大型语言模型（LLM）客户端。

模型上下文协议是什么？

模型上下文协议（MCP）是一个开放协议，标准化了应用程序如何向大型语言模型（LLM）提供上下文。就像USB-C端口提供了一种标准化的方式连接设备到各种外围设备一样，MCP提供了一种标准化的方式连接AI模型到不同的数据源和工具。

这个项目实现了一个FastMCP服务器，包含几个有用的工具，使Claude和其他LLM能够与本地文件系统交互并执行命令。它通过明确定义的工具接口以受控方式扩展了LLM的本地系统访问能力。

MCP的主要优势

标准化集成：MCP提供了一个不断增长的预构建集成列表，您的LLM可以直接插入这些集成
供应商灵活性：轻松在LLM提供商之间切换（如Claude、GPT-4o、Gemini等）
安全性：在基础设施内保护数据的最佳实践
工具暴露：封装现有工具，并使其对任何兼容MCP的LLM客户端可用

特性

MCP服务器提供了以下文件系统和命令执行工具：

execute_shell_command：执行shell命令并获取stdout/stderr结果
show_file：查看文件内容，可选指定行范围
search_in_file：使用正则表达式在文件中搜索模式
edit_file：通过字符串替换和行操作精确修改文件
write_file：写入或追加内容到文件

MCP架构

MCP遵循客户端-服务器架构：

主机：发起连接的LLM应用程序（如Claude桌面或IDE）
客户端：在主机应用程序内部与服务器保持一对一的连接
服务器：向客户端提供上下文、工具和提示（本项目实现了服务器）

预备条件

Python 3.10或更高版本
兼容MCP的客户端（如Claude桌面或其他支持MCP的客户端）

安装

安装uv
克隆此仓库或下载源代码
运行uv run mcp install来安装MCP服务器
运行which uv以获取uv可执行文件的绝对路径
在Claude桌面中更新MCP服务器配置，使用uv可执行文件的绝对路径

我的MCP服务器配置如下：

{
  "globalShortcut": "",
  "mcpServers": {
    "zbigniew-mcp": {
      "command": "/Users/zbigniewtomanek/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "marker-pdf",
        "mcp",
        "run",
        "/Users/zbigniewtomanek/PycharmProjects/my-mcp-tools/server.py"
      ]
    }
  }
}

使用方法

从Claude桌面连接

打开Claude桌面
使用标识符“zbigniew-mcp”连接到MCP服务器

注意：虽然此实现侧重于Claude桌面，但MCP设计为与任何兼容MCP的工具或LLM客户端兼容，提供实施和集成的灵活性。

可用工具

execute_shell_command

安全地使用参数列表执行shell命令：

execute_shell_command(["ls", "-la"])
execute_shell_command(["grep", "-r", "TODO", "./src"])
execute_shell_command(["python", "analysis.py", "--input", "data.csv"])
execute_shell_command(["uname", "-a"])

show_file

查看文件内容，可选指定行范围：

show_file("/path/to/file.txt")
show_file("/path/to/file.txt", num_lines=10)
show_file("/path/to/file.txt", start_line= 5, num_lines=10)

search_in_file

使用正则表达式在文件中搜索模式：

search_in_file("/path/to/script.py", r"def\s+\w+\s*\(")
search_in_file("/path/to/code.py", r"#\s*TODO", case_sensitive=False)

edit_file

精确修改文件：

# 替换文本
edit_file("config.json", replacements={"\"debug\": false": "\"debug\": true"})

# 在第5行插入
edit_file("script.py", line_operations=[{"operation": "insert", "line": 5, "content": "# 新注释"}])

# 删除第10-15行
edit_file("file.txt", line_operations=[{"operation": "delete", "start_line": 10, "end_line": 15}])

# 替换第20行
edit_file("file.txt", line_operations=[{"operation": "replace", "line": 20, "content": "更新的内容"}])

write_file

写入或追加内容到文件：

# 覆盖文件
write_file("/path/to/file.txt", "新内容")

# 追加到文件
write_file("/path/to/log.txt", "日志条目", mode="a")

fetch_page

抓取网页内容到PDF（需要安装chromium），然后使用本地LLM解析为markdown：

fetch_page("https://example.com")

传输机制

MCP支持多种通信传输方法：

标准输入/输出（stdio）：使用标准输入/输出进行通信，适合本地进程
服务器发送事件（SSE）：启用服务器到客户端的流媒体，使用HTTP POST请求进行客户端到服务器的通信

此实现使用一个本地MCP服务器，通过文本输入/输出进行通信。

使用您自己的工具扩展

您可以轻松地通过添加带有@mcp.tool装饰器的新工具来扩展此MCP服务器。按照server.py中的模式创建新工具，以向您的LLM客户端暴露额外的功能。

安全注意事项

MCP服务器为Claude提供了对您本地系统的访问权限。请注意以下事项：

服务器作为您的用户执行shell命令
它可以读取、写入和修改系统上的文件
如果安全是主要考虑因素，请考虑限制对特定目录的访问