基本能力
产品定位
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
适用场景
- 为 LLM 提供本地文件系统访问能力
- 在 LLM 中执行本地命令
- 在 LLM 中进行文件编辑和搜索
- 网页内容抓取和转换
工具列表
- execute_shell_command: 安全执行 shell 命令
- show_file: 查看文件内容
- search_in_file: 在文件中搜索模式
- edit_file: 精确编辑文件
- write_file: 写入或追加内容到文件
- fetch_page: 获取网页内容并转换为 PDF 和 Markdown
常见问题解答
- 安全问题:MCP 服务器以用户权限执行命令和访问文件,需注意安全
- 兼容性:支持任何 MCP 兼容的客户端
使用教程
使用依赖
- Python 3.10 或更高版本
- MCP 兼容客户端(如 Claude Desktop)
安装教程
- 安装 uv: uv 安装指南
- 克隆仓库或下载源代码
- 运行
uv run mcp install
安装 MCP 服务器 - 运行
which uv
获取 uv 可执行文件的绝对路径 - 在 Claude Desktop 中更新 MCP 服务器配置,使用 uv 的绝对路径
调试方式
- 打开 Claude Desktop
- 使用标识符 "zbigniew-mcp" 连接到 MCP 服务器
- 测试工具功能,如
execute_shell_command(["ls", "-la"])