JinDaGe - master_mcp_server MCP Details

article

README

🚀 AI 主控程序 (MCP) 服务器

AI MCP 服务器为 AI 模型（包含本地运行的模型，如 Ollama 和 Claude Desktop）搭建了与计算机系统交互的桥梁。借助该服务器，AI 模型能够执行系统命令、进行文件操作、控制其他程序以及与其他程序通信。

🚀 快速开始

AI MCP 服务器让 AI 模型能与计算机系统交互。它作为中间桥梁，支持多种操作，如执行系统命令、文件操作、程序控制和通信等。

✨ 主要特性

支持 AI 模型执行系统命令，实现对计算机系统的灵活控制。
允许 AI 模型进行文件的创建、读取、更新和删除操作。
可控制其他程序的运行，并与其他程序进行通信。
系统架构模块化，包含 MCP 服务器、客户端库、模型连接器和任务执行引擎，便于集成和扩展。

📦 安装指南

先决条件

Python 3.8+
Ollama（可选，用于本地模型托管）
Claude Desktop（推荐的默认模型）

自动化安装

为实现快速便捷安装，可使用提供的安装脚本：

# 克隆仓库
git clone https://github.com/GrizzFuOnYou/master_mcp_server.git
cd master_mcp_server

# 运行安装脚本
python install.py

安装脚本会完成以下操作：

验证 Python 版本兼容性。
安装所有依赖项。
创建目录结构。
配置环境变量。
创建平台特定的启动脚本。
设置 Claude Desktop 为默认 AI 模型。

手动设置

若需手动安装，可按以下步骤操作：

克隆仓库：

git clone https://github.com/GrizzFuOnYou/master_mcp_server.git

安装依赖项并运行服务器。

📚 详细文档

服务端接口

| 接口路径 | 请求方式 | 描述 | |----------|---------|------| | /connect_model | POST | 连接 AI 模型 | | /disconnect_model/{model_id} | POST | 断开与 AI 模型的连接 | | /list_models | GET | 列出所有已连接的模型 | | /execute_task | POST | 执行由 AI 模型请求的任务 | | /task_status/{task_id} | GET | 获取任务状态 |

客户端方法

| 方法 | 描述 | |------|------| | connect_model(model_id, model_type, config) | 连接 AI 模型 | | disconnect_model(model_id) | 断开与 AI 模型的连接 | | list_models() | 列出所有已连接的模型 | | execute_system_command(model_id, command, args, working_dir, timeout) | 执行系统命令 | | execute_file_operation(model_id, operation, path, content) | 执行文件操作 | | control_program(model_id, action, program_path, args, pid) | 控制程序 | | query_model(model_id, target_model, prompt) | 查询 AI 模型 |

模型配置

Claude Desktop 配置

要连接到 Claude Desktop，请使用以下配置：

{
  "api_url": "http://localhost:5000/api",
  "temperature": 0.7,
  "max_tokens": 1000
}

Ollama 配置

要连接到 Ollama 模型，请使用以下配置：

{
  "host": "http://localhost:11434"
}

🔧 技术细节

系统架构

该系统由以下部分组成：

MCP 服务器：作为中央服务器，负责处理来自 AI 模型的请求。
客户端库：方便与 AI 模型进行集成。
模型连接器：用于与各种 AI 模型后端接口（如 Ollama、Claude Desktop 等）进行连接。
任务执行引擎：执行系统操作和程序控制。

⚠️ 安全注意事项

⚠️ 重要提示

此服务器授予 AI 模型对您系统的大量访问权限，请谨慎使用。

实施的安全措施包括：

API 密钥身份验证
所有操作的日志记录
可配置的权限（即将推出）
速率限制（即将推出）

🛠️ 故障排除

Claude Desktop 连接问题

若遇到连接到 Claude Desktop 的问题，可按以下步骤排查：

确保 Claude Desktop 正在运行。
验证 API URL（默认：http://localhost:5000/api）。
检查日志中的具体错误信息。
重新启动 Claude Desktop 并再次尝试。

Ollama 连接问题

若遇到连接到 Ollama 的问题，可按以下步骤排查：

确保 Ollama 正在运行（ollama serve）。
验证模型存在（ollama list）。
检查 API URL（默认：http://localhost:11434）。
尝试再次拉取模型（ollama pull modelname）。

🚀 扩展点

MCP 服务器可扩展以下功能：

支持更多 AI 模型。
增加更多任务类型。
实现高级安全措施。

📄 许可证

请查看项目的许可证文件，以了解使用和分发的条款。

🤝 贡献指南

如果您希望为该项目做出贡献，请参考贡献者指南文档。

📞 联系方式

如需联系项目维护人员，请发送邮件至 project.contact@example.com。

master_mcp_server