哈利波特数据服务

一个提供哈利波特宇宙数据访问的MCP服务器,支持通过效果搜索咒语、获取角色详情和列出所有咒语。

  • by johannesplanis
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 johannesplanis/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用于获取《哈利·波特》宇宙数据。