猫事实服务

一个基于FastAPI和服务器发送事件(SSE)的猫事实服务,提供随机猫事实和实时猫事实流。

  • by akream
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 akream/mcppython

使用说明

Python MCP猫事实

一个FastAPI服务器,它使用服务器发送事件(SSE)传输来实现模型上下文协议(MCP),以提供猫事实。

特性

  • 获取一个随机的猫事实
  • 订阅每10秒发送一次的猫信息流
  • SSE(服务器发送事件)用于实时通信
  • 带有自动OpenAPI文档的FastAPI框架

需求

  • Python 3.12+
  • 依赖关系:
    • 快速
    • mcp[cli]
    • 优维康
    • cmake

安装

克隆存储库

git clone <repository-url>
cd python-mcp

创建虚拟环境

python -m venv venv
source venv/bin/activate  # On Windows, use: venv\Scripts\activate

安装依赖项

pip install -e .

以SSE模式启动服务器

使用uv run命令启动服务器:

uv run start

服务器运行后,它将在以下位置可用:

  • APIhttp://localhost:8000
  • API文件:http://localhost:8000/docs

VS代码集成

要将此MCP服务器与VS代码一起使用,您需要将以下配置添加到您的 mcp.json 文件:

{
    "servers": {
        "mcp-sse": {
            "type": "sse",
            "url": "http://0.0.0.0:8000/sse"
        }
    }
}

此配置告诉VS-Code如何使用SSE传输连接到MCP服务器。

使用Cat Facts API

获取一个关于猫的事实:

连接到SSE端点并请求单个猫事实。回复总是以“嗨!”开头。

API终点

  • GET /:主页
  • GET /about:关于应用程序的信息
  • GET /status:当前服务器状态
  • GET /sse:MCP通信的SSE端点
  • GET /docs:API文档(Swagger UI)
  • GET /redoc:API替代文件(ReDoc)

许可证

麻省理工学院