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.