mcp-animenewsnetwork

mcp-animenewsnetwork

Anime News Network 自 1998 年起持续报道动漫和漫画。它维护着一部作品百科全书，收录作品的演职员、剧集、发行版本、片头曲和片尾曲，以及读者评分；同时还运营新闻栏目，并分别推出美国、英国和澳大利亚版。

此服务可将聊天客户端连接到这两项内容。你可以搜索动漫或漫画的百科条目，查看包含演职员信息和详细资料的单个条目，列出最新收录内容或按字母顺序浏览百科全书，还可以阅读新闻。无需 API 密钥或账号。

法语版本

---

安装

一键安装

Claude Code

claude mcp add animenewsnetwork -- npx -y mcp-animenewsnetwork

Claude Desktop、Cursor，以及使用标准配置格式的任意客户端

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "npx",
      "args": ["-y", "mcp-animenewsnetwork"]
    }
  }
}

需要 Node 24 或更高版本，无需设置环境变量。

使用 Docker

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-animenewsnetwork:3.0.0"]
    }
  }
}

-i 会保持 stdin 打开，协议通过它传输；不使用 -t，因为 TTY 会重写数据流。容器需要能够通过 HTTPS 访问 cdn.animenewsnetwork.com 和 www.animenewsnetwork.com，除此之外无需任何配置：不需要卷、端口或凭据。

使用 Bundle，无需 npm

从最新版本下载 mcp-animenewsnetwork-2.0.1.mcpb 并打开。支持 MCP bundle 的客户端会自行安装，无需 npm，也无需编辑配置文件。bundle 包含所需依赖，因此安装时不会下载任何内容。

可询问的内容

• “百科全书中关于 Cowboy Bebop 的内容是什么？”
• “Spike 由谁配音，使用了哪些语言？”
• “最近添加了哪些动画到百科全书中？”
• “今天的动画新闻是什么？”
• “读者如何评价那部作品？”

常规流程是先搜索，再查看条目：每一行都带有 id 和 kind，而 get_title 需要同时提供这两个值。

工具

工具	功能
search_titles	按标题在百科全书中查找动画和漫画。
get_title	读取一个条目及其演职人员和详细信息。
list_recent	列出最近添加的内容，或按字母浏览百科全书。
get_news	读取新闻稿。

条目由其 id 和 kind 共同标识，因为百科全书分别为动画和漫画编号。

search_titles

按标题查找动画和漫画。

参数	类型	必填	功能
query	字符串，至少 1 个字符	是	标题或标题的一部分。
kind	anime、manga 或 both，默认值为 both	否	要搜索的百科全书部分。
limit	整数，1 到 50，默认值为 10	否	返回的行数。

**返回内容：**包含 id 和 kind 的行，get_title 需要同时提供这两个值； name；type，表示 TV、电影、OAV、ONA、特别篇、漫画或小说； precision；vintage，即已发布的原始发行日期或日期范围；以及 source_url。条目中留空的字段会返回 null。

get_title

读取一个条目。较长的内容需要主动请求，不会默认返回。

参数	类型	必填	功能
id	整数，1 或更大	是	百科全书条目 ID。
kind	anime 或 manga	是	此 ID 所属的查询类型。
sections	basic、cast、staff、episodes、releases、related、news、reviews 组成的数组，默认值为 ["basic"]	否	要返回的部分。
max_chars	整数，200 到 20000，默认值为 4000	否	要返回的剧情简介长度。
offset	整数，0 或更大，默认值为 0	否	剧情简介的续读位置。

返回内容：title，即搜索结果行中带有的条目；无论请求了哪些内容，都会返回该字段，以便引用任何答案。请求 basic 时还会返回 alt_titles、genres、themes、episode_count、running_time、 objectionable_content、official_websites、picture_url、opening_themes 和 ending_themes。 ratings 包含读者的 votes、weighted_score 和 bayesian_score；百科全书未计算的值为 null。plot_summary 会分段返回，并由 total_chars、returned_chars、offset、 next_offset 和 truncated 描述。配音条目会列出 role、person，以及其配音所用的 lang。

list_recent

列出最近添加到百科全书的内容，或按首字母浏览。

参数	类型	必填	说明
kind	anime, manga, person or company, default anime	否	要列出的内容类型。
starts_with	a single character	否	浏览以该字符开头的条目。
limit	integer, 1 to 50, default 20	否	返回的行数。
offset	integer, 0 or more, default 0	否	分页时跳过的行数。

返回内容： rows，每行包含 id、kind、name、type、precision、 vintage、date_added 和 source_url，报告可能会将其中任意字段留空。mode 表示 答案是按 recent 读取还是按 browse 读取，因为传入 starts_with 会改变所询问的 内容；next_offset 用于继续获取。

get_news

读取新闻快讯流。

参数	类型	必填	说明
feed	all, news or reviews, default all	否	要读取的新闻源。
edition	us, uk or au, default us	否	要读取的版本。
category	string	否	仅保留带有此标签的报道。
limit	integer, 1 to 100, default 20	否	返回的报道数。

返回内容： items，每项包含 title、link、summary、categories （包含新闻源为该报道附带的所有标签），以及 published_at（当新闻源提供的日期可读取时， 为 ISO 时间戳）。 total_available 表示新闻源中包含的报道数量，这是新闻源的固定长度，而非存档的大小。

配置

所有变量均为可选。在客户端配置的 env 区块中设置。

变量	默认值	说明
ANN_USER_AGENT	项目标识	向服务标识你的应用，并提供可供联系的地址。
ANN_MIN_INTERVAL_MS	1100	两次请求之间的间隔，范围为 1000 到 60000。
ANN_TIMEOUT_MS	15000	单次请求的截止时间，范围为 1000 到 120000。
ANN_MAX_RETRIES	3	瞬时故障后的重试次数，范围为 0 到 10。
ANN_CACHE_TTL_MS	3600000	百科全书条目在内存中的保留时长，范围为 0 到 86400000。
ANN_NEWS_CACHE_TTL_MS	300000	新闻源在内存中的保留时长，范围为 0 到 86400000。
ANN_CACHE_MAX_ENTRIES	200	内存中同时保留的答案数，范围为 0 到 10000。
ANN_LOG_LEVEL	error	silent、error、info 或 debug，写入 stderr。

新闻快讯流每小时发布多次，而百科全书的更新较少，因此两者的保留时长不同。超出范围的值 将回退为默认值，原因会写入 stderr。

错误

每次失败都会附带六种代码之一、一条消息，以及在有帮助时提示下一步操作的说明。

代码	发生了什么	应采取的操作
not_found	服务已响应，但没有该条目。	使用 search_titles 检查 ID 和类型。
invalid_input	请求发出前，参数就被拒绝了。	阅读消息，其中会指出相关参数。
rate_limited	服务要求此客户端降低请求速度。	等待提示中所述的秒数，然后使用相同参数再次调用。该条目仍然存在。
parse_failure	收到的响应格式无法由此客户端读取。	在问题跟踪器中报告。
network_error	请求未能完成。	稍后重试。
timeout	请求超时。	调高 ANN_TIMEOUT_MS，或减少请求的行数。

作为库使用

读取服务的这一层单独发布，包含自己的请求节奏控制、缓存和错误处理，且不绑定任何协议。

import { AnnClient } from "mcp-animenewsnetwork/client";

const client = new AnnClient();
const { data, cached } = await client.getTitle("anime", 1);
console.log(data.name, cached);

每次读取都会返回 { data, cached }，并在出错时抛出携带六种代码之一的错误。两次请求之间的最短间隔在这里同样适用。

请求节奏与署名

请求会逐个发出，间隔至少为 1.1 秒；无论服务端如何配置，最短间隔都不会低于 1 秒。User-Agent 的末尾始终包含项目标识和可联系到相关人员的地址。

每个结果都会附带百科页面或文章的地址。百科和新闻由 Anime News Network 及其贡献者创作，服务要求以署名作为回报。

此 MCP 服务是一个非官方项目，与 Anime News Network 没有任何关联。

隐私

此服务不会收集任何关于你的信息，也不会向其作者发送任何信息。它在你的机器上运行，只会联系 cdn.animenewsnetwork.com 和 www.animenewsnetwork.com，除此之外不会联系其他地址；运行期间会将响应保存在内存中，不会写入磁盘。PRIVACY.md 说明了请求会携带哪些信息，以及哪些设置会改变这些信息。

开发

npm install
npm run build:fixtures
npm test
npm run check

测试使用生成的测试数据，不会发起网络请求。实时测试套件 npm run test:live 会对每个路由发出一次请求，并每晚针对服务本身运行。

贡献

漏洞、问题和想法请提交到问题跟踪器。欢迎提交拉取请求；先创建问题有助于就变更方案达成一致。请参阅 CONTRIBUTING.md。

许可证

MIT，详见 LICENSE。百科和新闻归 Anime News Network 及其贡献者所有。

---

mcp-animenewsnetwork（法语）

English version

Anime News Network 自 1998 年起报道动漫和漫画。该网站维护着一部作品百科全书，收录作品本身的信息、每部作品的配音演员和演职人员、剧集、发行作品、片头曲和片尾曲，以及读者评分；此外还运营着新闻动态，分别推出美国、英国和澳大利亚版本。

此服务可将对话客户端连接到这两项内容。你可以在百科全书中搜索动漫或漫画，查看包含演职人员名单和详细信息的作品条目，列出最近新增的内容或按字母浏览百科全书，还可以阅读新闻动态。无需 API 密钥，也无需账号。

安装

一键安装

Claude Code

claude mcp add animenewsnetwork -- npx -y mcp-animenewsnetwork

Claude Desktop、Cursor 及所有采用标准配置格式的客户端

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "npx",
      "args": ["-y", "mcp-animenewsnetwork"]
    }
  }
}

需要 Node 24 或更高版本，无需设置环境变量。

使用 Docker

{
  "mcpServers": {
    "animenewsnetwork": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-animenewsnetwork:3.0.0"]
    }
  }
}

-i 会保持标准输入打开，它是协议通道；省略 -t 是因为 TTY 会重写数据流。容器需要能够通过 HTTPS 访问 cdn.animenewsnetwork.com 和 www.animenewsnetwork.com，除此之外无需任何其他配置：不需要卷、端口或凭据。

Bundle，无需 npm

从最新发布版本下载 mcp-animenewsnetwork-2.0.1.mcpb 并打开。支持 MCP bundle 的客户端会自动安装，无需 npm，也无需修改配置文件。Bundle 内含所需依赖，因此安装时不会下载任何内容。

可以询问什么

• “百科全书中关于 Cowboy Bebop 的内容有哪些？”
• “谁为 Spike 配音？分别使用了哪些语言？”
• “百科全书最近新增了哪些动漫？”
• “今天的动漫新闻有哪些？”
• “读者给这部作品打了多少分？”

常见流程是先搜索，再查看作品条目：搜索结果行会包含 id 和 kind，get_title 会同时使用这两个值。

工具

工具	功能
search_titles	在百科全书中按标题查找动漫和漫画。
get_title	查看作品条目、演职人员名单和详细信息。
list_recent	列出最近新增的内容，或按字母浏览百科全书。
get_news	阅读新闻动态。

查看作品条目时，需要同时提供 id 和 kind，因为百科全书对动漫和漫画分别编号。

search_titles

按标题查找动漫和漫画。

参数	类型	必填	说明
query	字符串，至少 1 个字符	是	标题或标题片段。
kind	anime、manga 或 both，默认值为 both	否	百科类别。
limit	整数，1 至 50，默认值为 10	否	返回的条目数。

**返回内容：**包含 id 和 kind 的条目，供 get_title 一并使用；name；type，取值为 TV、movie、OAV、ONA、special、manga 或 novel；precision；vintage，即已发布的发行日期或时期；以及 source_url。资料页中为空的字段将返回 null。

get_title

读取资料页。较大的内容需按需请求，不会默认返回。

参数	类型	必填	说明
id	整数，1 或更大	是	百科条目 ID。
kind	anime 或 manga	是	ID 所属的登记类别。
sections	basic、cast、staff、episodes、releases、related、news、reviews 组成的数组，默认值为 ["basic"]	否	要返回的部分。
max_chars	整数，200 至 20000，默认值为 4000	否	返回的摘要长度。
offset	整数，0 或更大，默认值为 0	否	摘要的起始位置。

返回内容：title，即搜索结果条目所对应的资料页，无论请求什么内容都会返回，以便引用所有答复。请求 basic 时，还会返回 alt_titles、genres、themes、episode_count、running_time、objectionable_content、official_websites、picture_url、opening_themes 和 ending_themes。 ratings 包含读者的 votes、weighted_score 和 bayesian_score；百科未计算的值为 null。 plot_summary 分段返回，并附有 total_chars、returned_chars、offset、next_offset 和 truncated 字段。配音条目包含 role、person，以及其出演时使用的语言 lang。

list_recent

按最近添加的条目列出百科内容，或按首字母浏览。

参数	类型	必需	作用
kind	anime、manga、person 或 company，默认值为 anime	否	要列出的内容类型。
starts_with	单个字符	否	浏览以该字符开头的条目。
limit	整数，1 到 50，默认值为 20	否	返回的行数。
offset	整数，0 或更大，默认值为 0	否	要跳过的行数，用于分页。

返回内容： rows，每项包含 id、kind、name、type、 precision、vintage、date_added 和 source_url；报告可能会将这些字段留空。 mode 表示响应是按 recent 读取还是按 browse 读取；传入 starts_with 会改变查询方式，而 next_offset 用于继续读取。

get_news

读取新闻动态。

参数	类型	必需	作用
feed	all、news 或 reviews，默认值为 all	否	要读取的动态流。
edition	us、uk 或 au，默认值为 us	否	版本。
category	字符串	否	仅保留带有此标签的主题。
limit	整数，1 到 100，默认值为 20	否	返回的主题数。

返回内容： items，每项包含 title、link、summary、categories（包含动态流为该主题设置的每个标签），以及在成功读取动态流日期时以 ISO 时间戳表示的 published_at。 total_available 是动态流中包含的主题数，这是动态流的固定长度，并非存档大小。

配置

每个变量都是可选的。将它们设置在客户端配置的 env 块中。

变量	默认值	作用
ANN_USER_AGENT	项目标识	向服务标识您的应用，并提供可联系到相关人员的地址。
ANN_MIN_INTERVAL_MS	1100	两次请求之间的间隔，范围为 1000 到 60000。
ANN_TIMEOUT_MS	15000	请求超时时间，范围为 1000 到 120000。
ANN_MAX_RETRIES	3	临时失败后的重试次数，范围为 0 到 10。
ANN_CACHE_TTL_MS	3600000	条目在内存中的保留时间，范围为 0 到 86400000。
ANN_NEWS_CACHE_TTL_MS	300000	动态流在内存中的保留时间，范围为 0 到 86400000。
ANN_CACHE_MAX_ENTRIES	200	同时保留在内存中的响应数，范围为 0 到 10000。
ANN_LOG_LEVEL	error	可选值为 silent、error、info 或 debug，日志写入错误输出。

新闻动态每小时发布多次，而百科内容很少变动，因此两者的缓存时长不同。超出范围的值会回退到默认值，原因会写入错误输出。

错误

每次失败都会带有六种代码之一、一条消息，以及在有帮助时提供的下一步操作提示。

代码	发生了什么	应采取的操作
not_found	服务已响应，但没有这条记录。	使用 search_titles 检查标识符和类型。
invalid_input	请求发出前，参数已被拒绝。	阅读消息，其中会指出相关参数。
rate_limited	服务要求此客户端放慢速度。	等待指定的秒数，然后使用相同参数重试。这条记录仍然存在。
parse_failure	响应已收到，但无法在此处解析。	请在问题跟踪页报告。
network_error	请求未能完成。	稍后重试。
timeout	请求超时。	增大 ANN_TIMEOUT_MS，或减少请求的行数。

作为库使用

读取服务的这一层单独发布，包含自身的速率控制、缓存和错误处理，不绑定任何协议。

import { AnnClient } from "mcp-animenewsnetwork/client";

const client = new AnnClient();
const { data, cached } = await client.getTitle("anime", 1);
console.log(data.name, cached);

每次读取都会返回 { data, cached }，并抛出带有六种代码之一的错误。两次请求之间的最短间隔在此处同样适用。

速率控制与署名

请求会逐个发出，间隔至少为 1.1 秒；无论如何配置，间隔都不会少于 1 秒。User-Agent 始终以项目标识和联系地址结尾。

每项结果都包含百科页面或文章的地址。百科内容和新闻由 Anime News Network 及其贡献者创作，服务要求以此作为回报署名。

此 MCP 是一个非官方项目，与 Anime News Network 无关联。

隐私

此服务不会收集你的任何信息，也不会向作者发送任何内容。它在你的计算机上运行，只会访问 cdn.animenewsnetwork.com 和 www.animenewsnetwork.com，在运行期间将响应保存在内存中，也不会向磁盘写入任何内容。PRIVACY.md 说明每个请求会携带什么信息，以及哪些设置会改变这一点。

开发

npm install
npm run build:fixtures
npm test
npm run check

测试使用生成的 fixture 运行，不会发出任何请求。实时测试套件 npm run test:live 会为每条路由发出一个请求，并且每晚针对服务本身运行。

贡献

问题、疑问和想法都可以提交到问题跟踪页。欢迎提交修改建议；先创建工单有助于就改动形式达成一致。请参阅 CONTRIBUTING.md。

许可证

MIT，详见 LICENSE。百科内容和新闻归 Anime News Network 及其贡献者所有。