Skip to main content
Glama
FRANhss

Agent中国通

by FRANhss

Agent中国通

让 AI Agent 真正接入中国互联网的 MCP 工具箱。

Node.js >=20 MCP TypeScript License: MIT

Agent中国通是一个面向中文圈的 Model Context Protocol Server。它把中国互联网常用能力包装成标准 MCP 工具,让 Claude Desktop、Cursor、Cherry Studio、Dify/OpenCode 等 Agent 可以安全、稳定地调用。

30 秒快速开始

npx -y agent-cn-tong banner
npx -y agent-cn-tong list-tools
npx -y agent-cn-tong doctor

作为 MCP Server 启动:

npx -y agent-cn-tong serve

源码调试:

npm install
npm run build
node dist/cli.js list-tools
node dist/cli.js serve

Related MCP server: Bing CN MCP Enhanced

支持工具

工具

分类

说明

配置

cn_time_now

time

中国时区当前时间

cn_amap_geocode

map

中文地址转经纬度

AMAP_API_KEY

cn_amap_regeocode

map

经纬度反查中文地址

AMAP_API_KEY

cn_amap_weather

map

中国城市天气

AMAP_API_KEY

cn_amap_place_search

map

中国 POI/地点搜索

AMAP_API_KEY

cn_express_track

logistics

中国快递轨迹查询

快递100或快递鸟授权

cn_rss_fetch

content

RSS/Atom 订阅读取、去重、排序、摘要控制

cn_bilibili_video_info

content

B站公开视频基础信息

cn_webpage_extract

web

公开网页正文提取,防 SSRF

cn_link_preview

web

公开链接预览

cn_ip_lookup

security

公网 IP 归属地/运营商查询

cn_holiday_info

utility

中国节假日/工作日查询,内置 2025/2026

cn_text_normalize

utility

中文文本清洗/脱敏

查看单个工具:

agent-cn-tong inspect cn_amap_weather
agent-cn-tong inspect cn_text_normalize --json

MCP 客户端配置

Claude Desktop / Cursor

{
  "mcpServers": {
    "agent-cn-tong": {
      "command": "npx",
      "args": ["-y", "agent-cn-tong", "serve"],
      "env": {
        "AMAP_API_KEY": "替换为你的高德 Web 服务 Key",
        "AGENT_CN_TONG_LOG_LEVEL": "warn"
      }
    }
  }
}

源码本地调试:

{
  "mcpServers": {
    "agent-cn-tong-local": {
      "command": "node",
      "args": ["/absolute/path/to/agent-cn-tong/dist/cli.js", "serve"],
      "env": {
        "AMAP_API_KEY": "替换为你的高德 Web 服务 Key"
      }
    }
  }
}

更多示例见 examples/

CLI

agent-cn-tong serve                 # 启动 MCP stdio server
agent-cn-tong list-tools [--json]   # 漂亮表格/JSON 列出工具
agent-cn-tong inspect <tool>        # 查看工具参数、配置、示例
agent-cn-tong doctor [--json]       # 彩色健康检查
agent-cn-tong config [--json]       # 展示配置说明
agent-cn-tong init [--json]         # 生成 .env.example 和客户端配置示例
agent-cn-tong banner                # 显示项目 banner
agent-cn-tong version               # 输出版本号

环境变量

AMAP_API_KEY=
EXPRESS_PROVIDER=              # kuaidi100 或 kdniao
KUAIDI100_CUSTOMER=
KUAIDI100_KEY=
KDNIAO_EBUSINESS_ID=
KDNIAO_API_KEY=
AGENT_CN_TONG_HTTP_TIMEOUT_MS=10000
AGENT_CN_TONG_HTTP_MAX_BYTES=2097152
AGENT_CN_TONG_HTTP_RETRIES=1
AGENT_CN_TONG_LOG_LEVEL=warn

高德地图

到高德开放平台创建 Web 服务 Key,配置 AMAP_API_KEY 后可使用高德相关工具。

快递查询

为了合规,项目不做未授权网页抓取。你需要选择一个授权服务商:

  • 快递100:EXPRESS_PROVIDER=kuaidi100,并配置 KUAIDI100_CUSTOMERKUAIDI100_KEY

  • 快递鸟:EXPRESS_PROVIDER=kdniao,并配置 KDNIAO_EBUSINESS_IDKDNIAO_API_KEY

部分快递公司可能要求手机号后四位,请在工具参数 phone 中传入。

常见任务示例

查一下北京望京 SOHO 的经纬度,然后找附近 2 公里内的咖啡店。
读取这个 RSS,按发布时间排序,总结最新 5 篇文章:https://example.com/feed.xml
帮我看这个 B 站视频的标题、UP 主和播放数据:BV1xx411c7mD
提取这个公开网页的正文摘要,并返回前 10 个链接:https://example.com/article
把这段群聊文本清洗一下,脱敏手机号和邮箱。
2026-10-01 是工作日吗?

安全与合规边界

Agent中国通坚持以下边界:

  • 不模拟登录、不绕过验证码、不绕过平台访问限制。

  • 不下载受版权保护或需登录授权的内容。

  • 不读取本地文件、内网地址、localhost 或 file 协议网页。

  • 不保存、不打印、不返回 API Key。

  • 网页工具默认禁止 localhost、内网、保留地址,降低 SSRF 风险。

  • 工具错误返回结构化 ok=falseerror.codeerror.messageerror.hint,方便 Agent 给用户修复建议。

开发

npm install
npm run typecheck
npm run lint
npm run format:check
npm run test
npm run build

单项测试:

npm run test:unit
npm run test:tools
npm run test:mcp
npm run test:cli

发布前建议:

npm run typecheck
npm run lint
npm run format:check
npm run test:unit
npm run test:tools
npm run test:mcp
npm run test:cli
npm run test
npm run build
npm pack --dry-run
node dist/cli.js list-tools
node dist/cli.js list-tools --json
node dist/cli.js doctor
node dist/cli.js doctor --json
node dist/cli.js inspect cn_time_now

路线图

  • 更多本土 API:飞书、企业微信、WPS、OCR。

  • 可选 Streamable HTTP 模式。

  • 工具市场式插件加载。

  • 更完整的中国节假日年度数据。

  • 更强网页正文抽取算法。

项目理念

国外 MCP 生态已经很丰富,但中文互联网服务适配还很分散。Agent中国通想做的是一个干净、可扩展、合规的中文 Agent 能力底座:

让你的 AI 终于认识中国互联网。

License

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FRANhss/Agent-'

If you have feedback or need assistance with the MCP directory API, please join our Discord server