Patronus MCP Server

🚀 項目標題 - 使用 Python 實現的 Model Context Protocol (MCP) 服務端

這是一個使用 Python 實現的 Model Context Protocol (MCP) 服務端項目。MCP 是用於與 AI 模型交互並獲取上下文信息的協議。本項目提供可擴展框架，開發者能通過插件添加新功能與工具。

🚀 快速開始

安裝依賴

pip install -r requirements.txt

初始化配置

創建一個 config.yaml 文件：

logging:
  level: INFO
  file: logs/app.log
  rotate: true
services:
  plugins:
    - plugin1
    - plugin2

啟動服務

python -m src.patronus_mcp.server --config config.yaml

✨ 主要特性

• 內置工具支持：提供了多個預定義的工具，如網絡請求、文件操作和數據分析等。
• 動態加載插件：支持通過插件形式動態擴展功能，便於維護和升級。
• 異步任務處理：採用異步編程模型，能夠高效處理高併發任務。
• 日誌與監控：集成了完善的日誌記錄和性能監控功能，便於調試和優化。

💻 使用示例

基礎用法

網絡請求工具

from patronus import tool

@tool()
def fetch_url(url: str) -> dict:
    """從指定 URL 獲取數據"""
    response = requests.get(url)
    return json.loads(response.text)

文件操作工具

from typing import List, Optional
from patronus import tool

@tool()
def read_file(path: str, encoding: Optional[str] = 'utf-8') -> List[str]:
    """讀取文件內容並返回行列表"""
    with open(path, 'r', encoding=encoding) as f:
        return [line.strip() for line in f.readlines()]

📚 詳細文檔

項目結構

patronus-mcp-server/
├── src/
│   └── patronus_mcp/
│       ├── __init__.py
│       └── server.py
├── tests/
│   └── test_server.py
    └── test_live.py
├── pyproject.toml
└── README.md

添加新功能

1. 在 server.py 中定義新的請求模型：

   class NewFeatureRequest(BaseModel):
       field1: str
       field2: Optional[int] = None
   

2. 使用 @mcp.tool() 裝飾器實現新功能：

   @mcp.tool()
   def new_feature(request: Request[NewFeatureRequest]) -> Any:
       """實現新的業務邏輯"""
       pass
   

3. 在測試文件中添加相應的測試用例：

   def test_new_feature():
       request = Request(...)
       response = new_feature(request)
       assert isinstance(response, ...)
   

運行測試

單元測試

pytest tests/test_server.py -v

集成測試

pytest tests/test_live.py -v

貢獻指南

1. Fork 該項目倉庫。
2. 創建新的功能分支：git checkout -b feature/new-feature
3. 提交代碼變更：git add . && git commit -m '添加新功能'
4. 推送到遠程倉庫：git push origin feature/new-feature
5. 提交 Pull Request 到主分支。

聯繫方式

• 項目郵箱：contact@example.com
• 開發者交流群：加入 QQ 群
• 官方文檔：訪問 官方文檔網站

📄 許可證

該項目遵循 MIT 許可證。以下是完整的許可內容：

版權所有 (c) 年份，作者姓名
您可以使用、複製、修改和分發此軟件，但必須遵守以下條件：

1. 在重新分發或派生作品中保留版權聲明和本許可聲明。
2. 不對軟件做任何虛假的宣傳或聲稱。
   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.