MCP Server Of9

🚀 MCP 服務器

MCP 服務器實現了模型上下文協議（MCP），為 AI 代理和大語言模型（LLM）提供了多種實用工具。這些工具涵蓋了基於 SearXNG 的網絡搜索功能以及文件系統操作，能有效滿足不同場景的需求。

🚀 快速開始

MCP 服務器為 AI 代理和大語言模型提供了豐富的工具支持。你可以快速通過以下代碼開啟使用：

# 使用內置的MCP服務器實例
from mcp_server.server import mcp

@mcp.tool()
def my_custom_tool(param1: str, param2: int = 10) -> dict:
    """我的自定義工具描述"""
    # 實現工具功能
    return {"result": f"Processed {param1} with {param2}"}

✨ 主要特性

• 網絡搜索：藉助 SearXNG 執行自定義參數的網絡搜索，高效且安全。
• 文件系統操作：支持文件的讀取、寫入和管理操作，同時具備安全控制機制。
• 可擴展架構：允許添加符合 MCP 協議的自定義工具，滿足多樣化需求。
• Docker 支持：推薦通過 Docker 運行服務器和相關服務，方便快捷。

📦 安裝指南

安裝需求

• Python 3.13 及以上版本
• uv 包管理器（直接安裝時使用）

Docker 安裝（推薦）

# 構建Docker鏡像
docker build -t mcp-server .

# 啟動服務器和SearXNG服務
docker-compose up

直接安裝

# 確保已安裝Python 3.13
python --version  # 應顯示類似 Python 3.13.x

# 安裝uv（如果尚未安裝）
pip install uv

# 創建虛擬環境並安裝依賴
uv venv --python=python3.13
uv install

# 啟動服務器
python -m mcp_server start --config config.env

💻 使用示例

基礎用法

現代客戶端示例

from mcp_client.session import ClientSession

# 初始化客戶端會話
session = ClientSession('http://localhost:8000')

# 調用工具
response = session.call_tool('my_custom_tool', param1='test')
print(response)

簡單客戶端示例

import requests

# 直接調用服務器API
url = 'http://localhost:8000/api'
data = {
    'tool': 'my_custom_tool',
    'params': {'param1': 'test'}
}
response = requests.post(url, json=data)
print(response.json())

高級用法

擴展開發 - 快速 MCP 方法

from mcp_server.server import mcp

@mcp.tool()
def my_custom_tool(param1: str, param2: int = 10) -> dict:
    """我的自定義工具描述"""
    # 實現工具功能
    return {"result": f"Processed {param1} with {param2}"}

擴展開發 - 原生架構

請參考開發者指南瞭解如何使用原生架構添加更多功能。

📚 詳細文檔

工具說明

• 網絡搜索：通過 SearXNG 實現高效、安全的網絡搜索。
• 文件系統操作：支持文件的讀取、寫入和刪除操作，帶權限控制。
• 擴展性：輕鬆集成新的 MCP 協議工具和服務。

配置環境變量

# 示例配置文件內容
MCP_SERVER__HOST=0.0.0.0
MCP_SERVER__PORT=8000
MCP_SEARXNG__INSTANCE_URL=http://localhost:8080/

客戶端示例位置

• examples/ 目錄下包含客戶端示例：
  • examples/client.py：現代客戶端使用 ClientSession API。
  • examples/simple_client.py：簡單客戶端直接調用 API。

📄 許可證

本項目遵循 MIT License 協議，詳見 LICENSE 文件獲取詳細信息。

致謝

• 模型上下文協議 提供協議規範。
• SearXNG 提供搜索功能實現。