mcp-tools

🚀 MCP 工具

MCP 工具是一个自定义的模型上下文协议（MCP）服务器实现，它能为 Claude Desktop 和其他 LLM 客户端提供文件系统和命令执行工具，极大地拓展了大型语言模型在本地系统的操作能力。

🚀 快速开始

本项目实现了一个 FastMCP 服务器，它集成了多个实用工具，让 Claude 和其他 LLM 能够与本地文件系统进行交互，并执行相关命令。通过定义完善的工具接口，以可控方式扩展了 LLM 在本地系统的访问能力。

✨ 主要特性

MCP 协议优势

• 标准化整合：MCP 提供了一个不断扩充的预建集成列表，LLM 可直接连接使用。
• 供应商灵活性：能轻松在不同 LLM 提供商（如 Claude、GPT - 4o、Gemini 等）之间进行切换。
• 安全性：采用符合最佳实践的安全措施，保护您基础设施中的数据。
• 工具暴露：将现有工具进行封装，使其能被任何支持 MCP 的 LLM 客户端访问。

具体功能

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

• execute_shell_command：执行 shell 命令，并获取 stdout/stderr 输出。
• fetch_page：抓取网页内容并转换为 PDF（需安装 chromium），随后通过本地 LLM 解析为 Markdown 格式。

传输机制

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

• 标准输入/输出(stdio)：利用标准输入输出进行通信，适合本地进程间的交互。
• 服务器发送事件(SSE)：通过 HTTP POST 请求实现服务器到客户端的流式通信。本实现采用本地 MCP 服务器，以文本输入/输出方式进行通信。

🔧 技术细节

什么是模型上下文协议？

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

⚠️ 安全注意事项

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

• 服务器以您的用户身份执行 shell 命令。
• 可以读取、写入和修改系统文件。
• 若安全是首要考虑因素，建议限制其访问特定目录。