MCP Server For Local

🚀 MCP 本地服務器代理

MCP 本地服務器代理是基於 MCP（多組件平臺）的本地代理服務器及客戶端實現，它提供了豐富的 AI 工具調用功能，能滿足多種場景的使用需求。

🚀 快速開始

環境配置

系統要求

• Python 3.8+
• Node.js（可選，用於運行 JavaScript 服務器）
• Chrome 瀏覽器（用於谷歌搜索功能）
• 攝像頭（用於拍照功能）
• 至少 4GB 內存
• 支持 CUDA 的顯卡（可選，用於加速 AI 計算）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/mcp-server-for-local.git
cd mcp-server-for-local

2. 創建並激活虛擬環境：

# Windows
python -m venv .venv
.venv\Scripts\activate

# Linux
python3 -m venv .venv
source .venv/bin/activate

3. 安裝依賴：

# 使用 uv 安裝依賴
uv pip install -r requirements.txt

# 如果遇到網絡問題，可以使用國內鏡像
uv pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

4. 配置環境變量：

cp config/.env.example config/.env

代理服務器啟動

1. 啟動代理服務器：

python3 src/mcp/proxy/app.py --port=8080

2. 訪問 http://localhost:8080 在瀏覽器中使用。

客戶端使用

1. 連接代理服務器：

curl http://localhost:8080/api/weather?city=London

✨ 主要特性

核心功能

• 天氣查詢：即時獲取全球任意位置的天氣信息，支持溫度、溼度、風速等詳細數據
• 谷歌搜索：智能檢索互聯網信息，支持多語言和高級搜索語法
• 攝像頭控制：支持拍照、視頻流和微表情分析，可用於情緒識別
• 圖片生成：集成 ComfyUI，支持文本到圖像的 AI 生成
• 智能對話：基於 DashScope 的 AI 對話能力，支持上下文理解和多輪對話

技術特性

• 跨平臺支持（Windows 和 Linux）
• 模塊化設計，易於擴展新功能
• 完整的日誌系統，便於調試和監控
• 支持自定義工具和 API 集成
• 高性能併發處理能力

📚 詳細文檔

開發指南

項目結構

src/mcp/
├── client/          # 客戶端代碼
├── proxy/           # 代理服務器代碼
├── tools/           # 工具實現
├── utils/           # 工具函數
└── config/          # 配置文件

添加新功能

1. 在 tools 目錄下創建新的工具類
2. 實現必要的接口方法
3. 在配置文件中註冊新工具
4. 編寫測試用例
5. 更新文檔

貢獻指南

歡迎提交 Issue 和 Pull Request！在提交之前，請確保：

1. 代碼符合項目規範
2. 添加了必要的測試
3. 更新了相關文檔
4. 通過了所有測試

📄 許可證

MIT License