动漫信息检索服务器

一个为Jikan API(非官方MyAnimeList API)设计的模型上下文协议(MCP)服务器,允许LLMs通过结构化接口搜索和检索动漫、漫画及相关系列信息。

  • by Mannvika
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Mannvika/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许可证-有关详细信息,请参阅许可证文件。

支持

相关项目