Jikan MCP Server

启用 MCP 服务器

Jikan API的模型上下文协议（MCP）服务器-非官方的MyAnimeList API。该服务器允许LLM通过结构化界面搜索和检索动漫、漫画和相关特许经营信息。

特性

• 动漫加盟搜索：获得完整的动漫特许经营权，包括季节、电影和衍生作品
• 智能高速缓存：用于API响应缓存的本地SQLite数据库
• 按时间顺序排序：按发布日期自动对特许经营内容进行排序
• 错误处理：通过有意义的消息进行稳健的错误处理

安装

全局安装（推荐）

npm install -g jikan-mcp-server

本地安装

npm install jikan-mcp-server

开发安装

git clone https://github.com/yourusername/jikan-mcp-server.git
cd jikan-mcp-server
npm install
npm run build

用法

作为MCP服务器

添加到您的MCP客户端配置中（例如，Claude Desktop）：

{
  "mcpServers": {
    "jikan": {
      "command": "jikan-mcp-server",
      "args": []
    }
  }
}

直接CLI使用

# Start the server
jikan-mcp-server

# Or if installed locally
npx jikan-mcp-server

可用工具

get_merged_anime_franchise

搜索动漫并返回包含所有相关内容的完整系列。

参数：

• query （string，必填）：要搜索的动漫名称

示例用法：

Search for "Attack on Titan" to get the complete franchise including:
- Attack on Titan (Season 1-4)
- All movies and OVAs
- Spin-offs and related series

发展

建筑

npm run build

发展模式

npm run dev

测试

npm test

配置

缓存位置

• 发展: ./cache.db （项目根）
• 生产: ~/.jikan-mcp-server/cache.db （用户主目录）

环境变量

• NODE_ENV=development：使用开发缓存位置
• NODE_ENV=production：使用生产缓存位置（默认）

API费率限制

此服务器使用Jikan API，该API具有速率限制：

• 未认证：3个请求/秒
• 已验证：30个请求/秒

内置缓存有助于最大限度地减少API调用并遵守速率限制。

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

支持

• 问题:
• 使用 API: 查看文档

相关项目

• 使用 API -非官方的MyAnimeList API
• 模型上下文协议 -此服务器实现的协议