myanimelist

This MCP server exposes tools that let an LLM client interact with the MyAnimeList API to search and fetch information about anime and manga, manage user lists, and retrieve details like rankings and seasonal data. The available tools are grouped under Anime, Manga, and User actions, enabling you to search, retrieve details, obtain rankings, access user-specific lists (with authentication), and perform updates or deletions to a user's MAL list. To use it, configure Claude Desktop (or another MCP client) to load this server via the uv-based runner, supply your MAL API credentials, and then invoke the specific tool functions such as get_anime, get_anime_details, get_manga_list, or update_myanimelist, depending on your workflow. Some actions require user authentication, so ensure your OAuth tokens are stored in the environment (env) vars or provided via your client before invoking protected endpoints.

Prerequisites:

• Python 3.8+ and the uvicorn/uv (uv) runner available in your environment
• Access to the MyAnimeList API with client_id and client_secret
• A working path where you will clone or place the myanimelist-mcp-server repository

Installation steps:

1. Install the MCP server package via your preferred method (this server is intended to run with uv and Python).
2. Ensure you have your MyAnimeList API credentials ready and set them in your environment or in a .env file (MAL_CLIENT_ID, MAL_CLIENT_SECRET, MAL_REDIRECT_URI).
3. Prepare your Claude Desktop (or MCP client) configuration to reference the server:
   • In Claude Desktop, add to claude_desktop_config.json under mcpServers like: { "mcpServers": { "myanimelist": { "command": "uv", "args": [ "--directory", "<path to your project>", "run", "main.py" ] } } }
4. Start the MCP server using the specified command/arguments in your environment. For example, run the uv command with the path to your project and the main.py entrypoint as shown in the config.
5. Verify the server is reachable by invoking a simple tool (e.g., get_anime with a basic query) from your MCP client.

Tips and considerations:

• Keep your MAL API credentials secure; do not commit them to public repos.
• Some actions require user authentication; ensure OAuth flow completes and tokens are stored in environment variables or a secure vault.
• The server expects a main.py entrypoint inside the configured directory that wires the MAL API client, authentication, and tool handlers.
• If you encounter connection issues, verify that the redirect URI (http://localhost:8080/callback by default) is allowed in your MAL API client settings.
• For debugging, monitor logs produced by uv to catch Python exceptions or API errors early.
• When updating lists (update_myanimelist, delete_myanimelist_item), ensure you have proper scopes authorized for the authenticated user.