CimiData MCP Server

次幽数据 API 的 MCP (Model Context Protocol) 服务器，提供微信公众号数据分析功能

📖 简介

本服务器将 次幂数据 API 封装为 MCP 服务器，让你可以在 Claude Desktop、Cline (VSCode) 或其他支持 MCP 的 AI 客户端中直接查询微信公众号数据，包括：

• 公众号基本信息
• 文章阅读量、点赞、在看、评论等数据
• 微信爆款文章、头条爆款文章
• 网络热榜
• 文章搜索等功能

✨ 功能特性

提供 13 个工具，涵盖公众号数据分析和内容发现：

公众号数据

• get_account_info - 获取公众号基本信息 (0.04元/次)
• get_today_articles - 获取当天发文情况 (0.04元/次)
• get_history_articles - 获取历史文章列表 (0.05元/次)

文章数据

• get_article_stats - 文章阅读/点赞/在看数 (0.02元/次)
• get_article_full_stats - 文章完整统计数据 (0.03元/次)
• get_article_content_full - 文章完整内容 HTML (0.01元/次)
• get_article_body - 文章正文内容 (0.01元/次)
• get_article_comments - 文章评论列表 (0.02元/次)

内容发现

• search_articles_wechat - 微信搜一搜 (0.05元/次)
• get_wechat_hot_articles - 微信爆款文章 (0.1元/次)
• get_toutiao_hot_articles - 头条爆款文章 (0.1元/次)
• get_hot_ranking - 网络热榜 (0.01元/次)

系统功能

• check_balance - 查询账户余额 (免费)

📦 安装

方式一：全局安装（推荐）

npm install -g cimi-data-mcp

方式二：本地安装

git clone https://github.com/oychao1988/cimi-data-mcp.git
cd cimi-data-mcp
npm install

⚙️ 配置

1. 获取 API 密钥

访问 次幽数据官网 注册账号并获取：

• app_id
• app_secret

2. 配置环境变量

在项目目录创建 .env 文件：

host=https://www.cimidata.com/
app_id=your_app_id
app_secret=your_app_secret

🚀 使用

在 Claude Desktop 中使用

编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "cimi-data": {
      "command": "node",
      "args": ["/path/to/cimi-data-mcp-server/index.js"],
      "env": {
        "host": "https://www.cimidata.com/",
        "app_id": "your_app_id",
        "app_secret": "your_app_secret"
      }
    }
  }
}

在 Cline (VSCode 插件) 中使用

点击 MCP Server 按钮，添加配置：

{
  "mcpServers": {
    "cimi-data": {
      "command": "node",
      "args": ["/path/to/cimi-data-mcp-server/index.js"],
      "env": {
        "host": "https://www.cimidata.com/",
        "app_id": "your_app_id",
        "app_secret": "your_app_secret"
      }
    }
  }
}

使用 Inspector 调试

npm run inspector

💬 使用示例

在对话中直接调用工具：

查询"人民日报"公众号的基本信息

获取今天的热门科技文章

搜索关于"人工智能"的文章

查看微博热榜

📋 API 文档

完整的 API 文档请参考：次幽数据 API 文档

🔧 开发

# 开发模式（自动重启）
npm run dev

# 启动服务
npm start

# 运行测试
npm test

# 启动 Inspector
npm run inspector

📊 价格说明

次幽数据 API 采用按次收费模式，具体价格请参考官方文档。每次调用工具都会消耗相应额度，请注意使用频率。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🔗 相关链接

• 次幽数据官网
• Model Context Protocol
• MCP SDK 文档

⚠️ 注意事项

1. API 有调用频率限制，请勿过于频繁调用
2. 首次查询某些公众号可能需要 30-60 秒采集数据
3. 请妥善保管你的 app_id 和 app_secret
4. 部分功能需要公众号已被系统收录才能查询

📮 联系方式

如有问题，请提交 GitHub Issue。

Made with ❤️ by the community