Python MCP 猫事实

一个使用 Server-Sent Events (SSE) 传输实现 Model Context Protocol (MCP) 的 FastAPI 服务器，提供猫的事实。

特性

• 获取单个随机猫的事实
• 订阅每10秒发送一次的猫事实流
• 使用 SSE（Server-Sent Events）进行实时通信
• 基于 FastAPI 框架，并自动生成 OpenAPI 文档

要求

• Python 3.12+
• 依赖项：
  • fastapi
  • mcp[cli]
  • uvicorn
  • cmake

安装

克隆仓库

bash
git clone
cd python-mcp

创建虚拟环境

bash
python -m venv venv
source venv/bin/activate # 在 Windows 上使用: venvScriptsactivate

安装依赖项

bash
pip install -e .

以 SSE 模式启动服务器

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

bash
uv run start

一旦服务器运行起来，它将可以通过以下地址访问：

• API: http://localhost:8000
• API 文档: http://localhost:8000/docs

VS Code 集成

要将此 MCP 服务器与 VS Code 结合使用，您需要在您的 mcp.json 文件中添加如下配置：

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

该配置告诉 VS Code 如何通过 SSE 传输连接到您的 MCP 服务器。

使用猫事实 API

获取单个猫的事实：

连接到 SSE 端点并请求单个猫的事实。响应总是以 "Hi!" 开头。

API 端点

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

许可证

MIT