MCP Server Cgb

🚀 MCP 服務器

MCP 服務器基於 Model Context Protocol (MCP) 協議構建，它為大型語言模型（LLMs）與外部工具及服務搭建了標準化的交互橋樑，極大提升了交互效率與規範性。

🚀 快速開始

MCP 服務器是基於 Model Context Protocol (MCP) 協議的服務器，允許大型語言模型（LLMs）與外部工具和外部服務以標準的方式進行交互。以下是啟動服務器的簡單步驟：

# 克隆倉庫
git clone <repository-url>
cd mcp-server

# 創建並激活虛擬環境
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 安裝所需的庫
pip install -r requirements.txt

# 運行服務器
python main.py

服務器將在 http://localhost:8000 運行。

✨ 主要特性

• 多工具支持：支持計算器、天氣、搜索等多種實用工具。
• RESTful API：基於 FastAPI 構建，提供標準的 RESTful API 接口。
• 數據驗證：使用 Pydantic 進行數據驗證，確保數據的準確性和完整性。
• 異步處理：具備高效的異步處理能力，提升系統響應速度。
• 自動生成文檔：自動生成帶有 Swagger UI 的 API 文檔，方便開發與調試。

📦 安裝指南

環境要求

• Python 3.8+
• pip（Python 包管理器）

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd mcp-server

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

python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

3. 安裝所需的庫：

pip install -r requirements.txt

💻 使用示例

基礎用法

根端點

curl http://localhost:8000

此請求將返回有關服務器的信息和受支持工具的列表。

執行工具

curl -X POST "http://localhost:8000/execute" -H "Content-Type: application/json" -d '{"tool_name": "calculator", "parameters": {"operation": "add", "numbers": [1, 2, 3]}, "context": {}}'

此請求將使用計算器工具執行加法運算。

高級用法

你可以根據需求組合不同的工具和參數，實現更復雜的功能。例如，結合天氣和搜索工具，先獲取某個地點的天氣信息，再根據天氣情況進行相關搜索。

📚 詳細文檔

API 端點

1. 根端點

• URL: /
• 方法: GET
• 描述: 返回有關服務器的信息和受支持工具的列表

2. 執行工具

• URL: /execute
• 方法: POST
• 描述: 使用提供的參數執行一個工具
• 請求體:

{
  "tool_name": "calculator",
  "parameters": {
    "operation": "add",
    "numbers": [1, 2, 3]
  },
  "context": {}
}

受支持的工具

1. 計算器

• 執行基本的數學運算
• 參數:
  • operation: "add" 或 "multiply"
  • numbers: 需要計算的數字數組

2. 天氣

• 獲取某個地點的天氣信息
• 參數:
  • location: 地點名稱

3. 搜索

• 執行網絡搜索
• 參數:
  • query: 搜索關鍵詞

API 文檔

訪問 http://localhost:8000/docs 查看完整的 API 文檔，帶有 Swagger UI。

🔧 技術細節

MCP 服務器使用 FastAPI 框架構建 RESTful API，利用 Pydantic 進行數據驗證，確保輸入數據的準確性。採用異步處理機制，提高服務器的併發處理能力。通過自動生成的 Swagger UI 文檔，方便開發人員查看和測試 API。

📄 許可證

本項目採用 MIT License 進行許可。