# Anitabi MCP Server

[中文](README_zh.md) | English

An MCP (Model Context Protocol) server that provides tools to search for anime (Bangumi) and find their corresponding *seichi junrei* (anime pilgrimage) locations using the [Bangumi API](https://bgm.tv/) and [Anitabi API](https://anitabi.cn/).

## Features

This server provides the following tools:

- `search_bangumi`: Search for an anime by name to get its Bangumi ID.
- `get_anime_lite_info`: Get lite info of seichi junrei locations for a specific anime using its Bangumi ID (includes top 10 iconic locations).
- `get_anime_detail_points`: Get detailed seichi junrei locations for a specific anime using its Bangumi ID.
- `get_map_url`: Get the URL to view the anime pilgrimage map in your browser. *(Note: This feature is currently disabled/unavailable due to API issues)*

## Installation

```bash
# Optional: Install via uv
uv tool install anitabi-mcpserver
```

## Configuration

Add the following to your MCP client configuration (e.g., Claude Desktop):

```json
{
  "mcpServers": {
    "anitabi-mcpserver": {
      "command": "uvx",
      "args": [
        "--refresh",
        "anitabi-mcpserver"
      ]
    }
  }
}
```

## Development

1. Clone the repository.
2. Run `uv build` to build the package.
3. Test locally using `uv run anitabi-mcpserver`.

## Acknowledgments

Special thanks to the following projects for providing the APIs that make this tool possible:
- [Bangumi API](https://github.com/bangumi/api)
- [Anitabi.cn API](https://github.com/anitabi/anitabi.cn-document)

*Note: For the Chinese version of this README, please check [README_zh.md](README_zh.md).*

## License

This project is licensed under the **AGPL-3.0 License with Commercial Restriction**. 
Please see the [LICENSE](LICENSE) file for details.