Potter MCP

波特MCP服务器

一个提供通过Potter API访问哈利·波特宇宙数据的最小MCP（模型上下文协议）服务器。

特点/功能

• 按效果查找法术按效果或使用场景搜索哈利·波特的咒语
• 获取角色详情获取关于哈利·波特角色的详细信息
• 列出所有法术获取所有可用的哈利·波特咒语的完整列表

安装

1. 安装依赖项：

pip install -r requirements.txt

1. 运行服务器：

python -m src.potter_mcp.server

工具

按效果查找法术

按法术效果或使用场景搜索法术。

参数：

• effect （字符串）：要搜索的效果（例如，“保护”、“照明”、“治疗”）

示例：

{
  "effect": "protection"
}

获取角色详情

获取关于哈利·波特角色的详细信息。

参数：

• name (字符串)：角色名称（全名或昵称）

示例：

{
  "name": "Harry"
}

列出所有法术

获取所有可用的哈利·波特咒语的完整列表。

参数： 无

示例：

{}

项目结构

src/
├── potter_mcp/
│   ├── __init__.py
│   ├── server.py          # Main MCP server
│   ├── api_client.py      # Potter API client
│   ├── models.py          # Pydantic data models
│   └── tools.py           # MCP tool implementations
└── __main__.py            # Entry point

数据源

这台服务器使用的是 波特API 由@fedeperin用于获取《哈利·波特》宇宙数据。