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。