MCP Tools
2025.03.23
0
PythonLLM 工具集成本地系统交互开发效率
ZbigniewTomanek_my-mcp-server 是一个自定义的 Model Context Protocol (MCP) 服务器实现，为 Claude Desktop 和其他 LLM 客户端提供文件系统和命令执行工具。MCP 是一个开放协议，标准化了应用程序如何向大型语言模型 (LLMs) 提供上下文。该项目实现了 FastMCP 服务器，通过定义良好的工具接口，以受控的方式扩展 LLMs 的本地系统访问能力。
View on GitHub
Overview
基本能力
产品定位
ZbigniewTomanek_my-mcp-server 是一个 MCP 服务器实现，旨在为 LLM 客户端提供本地文件系统和命令执行工具，增强 LLM 的本地系统交互能力。
核心功能
- execute_shell_command: 执行 shell 命令并获取 stdout/stderr 结果
- show_file: 查看文件内容，支持可选的行范围指定
- search_in_file: 使用正则表达式在文件中搜索模式
- edit_file: 通过字符串替换和行操作对文件进行精确修改
- write_file: 写入或追加内容到文件
- fetch_page: 将网页内容抓取为 PDF 并解析为 markdown（需要安装 chromium）
适用场景
- 为 LLM 客户端提供本地文件系统访问能力
- 在 LLM 交互中执行本地 shell 命令
- 通过 LLM 进行代码文件查看、搜索和编辑
- 网页内容抓取和解析
工具列表
- execute_shell_command: 安全执行 shell 命令
- show_file: 查看文件内容
- search_in_file: 在文件中搜索文本
- edit_file: 精确编辑文件内容
- write_file: 写入或追加文件内容
- fetch_page: 抓取网页内容并解析
常见问题解答
- 安全性: 服务器以用户权限执行 shell 命令，可以读写修改系统文件，建议限制访问特定目录
- 兼容性: 支持任何 MCP 兼容的 LLM 客户端，如 Claude Desktop
使用教程
使用依赖
- Python 3.10 或更高版本
- MCP 兼容客户端（如 Claude Desktop）
安装教程
- 安装 uv
- 克隆仓库或下载源代码
- 运行
uv run mcp install安装 MCP 服务器 - 运行
which uv获取uv可执行文件的绝对路径 - 在 Claude Desktop 中更新 MCP 服务器配置，使用
uv的绝对路径
示例配置:
{
"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 Desktop
- 使用标识符 "zbigniew-mcp" 连接到 MCP 服务器
- 测试工具功能，如执行
execute_shell_command(["ls", "-la"])