raportagent-mcp

Name: raportagent-mcp
Author: raportagent

本地服务

github.com/raportagent商业与营销014 周前更新

代码仓库

关于 raportagent-mcp

raportagent-mcp 将 MCP 客户端接入 RaportAgent，用于开展有来源依据的市场与合规研究。它生成报告，并通过 RaportAgent REST API 提供报告内容、引文、溯源信息和状态。

主要功能

01根据研究问题生成报告
02选择不同报告模板
03获取报告状态和 Markdown 内容
04检查来源与审计溯源信息
05取消报告并查看近期报告
06查询账户方案与额度

适用场景

01梳理监管环境
02研究市场或竞争对手
03核查引文和报告溯源信息

MCP 相关

这是一个 MCP 服务，为 MCP 客户端提供 RaportAgent 的报告生成、获取、状态查询、来源与审计查询、取消及账户操作工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "raportagent-raportagent": {
      "command": "npx",
      "args": [
        "-y",
        "@raportagent/mcp"
      ],
      "env": {
        "RAPORTAGENT_API_KEY": "<RAPORTAGENT_API_KEY>",
        "RAPORTAGENT_BASE_URL": "<RAPORTAGENT_BASE_URL>"
      }
    }
  }
}

启动命令npx -y @raportagent/mcp

需要配置的环境变量

RAPORTAGENT_API_KEY密钥Your RaportAgent API key (create one at raportagent.com under My account -> API keys)

RAPORTAGENT_BASE_URLOverride the API base URL (defaults to https://raportagent.com)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@raportagent/mcp0.1.2stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
depth	enum	否	deep = 约 15 分钟，全面；fast = 约 7 分钟。deep \| fast
query	string	是	要研究的市场／主题，例如 'EV charging infrastructure Europe 2026'。
template	enum	否	报告结构。法律／监管简报请使用 'compliance'。compliance \| pitch \| saas \| ecommerce \| realestate \| local
wait_seconds	integer	否	如果 >0，则持续轮询，直到报告完成或经过指定秒数（最大 1200 秒）。

详细介绍

RaportAgent MCP 服务

一个模型上下文协议服务，可将 RaportAgent 接入任何 MCP 客户端 — Claude Desktop、Claude Code、Cursor。让你的助手调研市场或梳理监管格局，它会生成一份带来源的 RaportAgent 报告，然后获取完整的 Markdown 报告及其审计记录。

这是 RaportAgent REST API（/v1）的轻量封装，因此会原样继承每个密钥的速率限制、积分机制和审计记录。

工具

工具	功能说明
`generate_report`	启动报告生成（`query`，可选 `template`：compliance/pitch/saas/ecommerce/realestate/local/battlecard/duediligence/fintech）。返回 `report_id`；也可通过 `wait_seconds` 轮询。消耗 1 个积分（`battlecard` 消耗 2 个）。
`get_report_status`	排队中 / 运行中 / 已完成 / 失败
`get_report`	完整的已完成报告 Markdown 内容及章节
`get_report_audit`	来源追溯信息：AI 模型、Agent、来源数量、确切内容的 SHA-256
`get_report_sources`	所有引用来源及其链接状态统计（正常 / 不确定 / 失效）
`cancel_report`	取消排队中或进行中的报告，并退还积分
`list_reports`	你的近期报告
`get_account`	剩余积分和套餐

设置

获取 API 密钥：RaportAgent → 我的账户 → API 密钥（ra_live_… 密钥）。
在 MCP 客户端中注册密钥 — 无需克隆或构建，npx 会拉取已发布的软件包。

Claude Desktop

将以下内容添加到 claude_desktop_config.json （macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\）：

{
  "mcpServers": {
    "raportagent": {
      "command": "npx",
      "args": ["-y", "@raportagent/mcp"],
      "env": {
        "RAPORTAGENT_API_KEY": "ra_live_xxx"
      }
    }
  }
}

Claude Code

claude mcp add raportagent -e RAPORTAGENT_API_KEY=ra_live_xxx -- npx -y @raportagent/mcp

Cursor

在 Cursor 的 MCP 设置中，使用与上方 Claude Desktop 相同的 command/args/env 结构。

从源码运行（仅用于贡献 / 调试）

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

然后将 command/args 指向 node / dist/index.js，并使用绝对路径，而不是 npx。

配置

环境变量	默认值	说明
`RAPORTAGENT_API_KEY`	—	必填。 `ra_live_…` 密钥。
`RAPORTAGENT_BASE_URL`	`https://raportagent.com`	覆盖此值以用于可自托管版本 / staging。

说明

生成报告通常需要约 15 分钟。generate_report 会立即返回 report_id；助手应在调用 get_report 前轮询 get_report_status（或传入 wait_seconds）。
stdout 用于 MCP 传输 — 服务只向 stderr 写入日志。
API 密钥只会发送到你配置的 RAPORTAGENT_BASE_URL。