Master MCP Server

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

AI MCP 服务器是一座桥梁，能让 AI 模型（包括本地运行的 Ollama 和 Claude Desktop 等模型）与计算机系统进行交互。它赋予了 AI 模型执行系统命令、操作文件、控制程序以及与其他程序通信等能力。

🚀 快速开始

AI MCP 服务器允许 AI 模型与计算机系统交互，可执行系统命令、操作文件、控制程序等。若你想快速体验，可按下面的安装步骤进行操作。

✨ 主要特性

• 系统交互：AI 模型可执行系统命令，如启动程序、查询系统信息等。
• 文件操作：支持创建、读取、更新和删除文件，方便数据管理。
• 程序控制：能够控制其他程序的启动、停止和运行状态。
• 多模型支持：兼容本地运行的模型，如 Ollama 和 Claude Desktop。

📦 安装指南

先决条件

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

自动化安装

为了快速且方便地安装，请使用提供的安装脚本：

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

# 运行安装脚本
python install.py

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

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

手动设置

如果需要手动安装：

1. 克隆仓库：

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

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

📚 详细文档

服务端接口

客户端方法

模型配置

Claude Desktop 配置

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

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

Ollama 配置

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

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

🔧 技术细节

系统架构

该系统由以下部分组成：

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

📄 许可证

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

⚠️ 重要提示

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

💡 使用建议

故障排除

• Claude Desktop 连接问题：若遇到连接问题，可确保 Claude Desktop 正在运行，验证 API URL（默认：http://localhost:5000/api），检查日志中的具体错误信息，重新启动 Claude Desktop 并再次尝试。
• Ollama 连接问题：若遇到连接问题，可确保 Ollama 正在运行（ollama serve），验证模型存在（ollama list），检查 API URL（默认：http://localhost:11434），尝试再次拉取模型（ollama pull modelname）。

扩展点

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

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

联系方式

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