Raportagent Mcp

io.github.raportagent由 GitHub 帳號 raportagent 發布v0.1.2更新於 Nov 3, 2026

Sourced market and compliance research for Claude Desktop, Claude Code and Cursor.

已驗證STDIO僅桌面網頁搜尋與抓取知識與記憶

概覽

AI 產生的概覽

RaportAgent MCP 讓助理產生附來源的市場與合規研究報告，並取回 Markdown 內容、引用來源與稽核紀錄。

可以做什麼
  • 依查詢啟動附來源的研究報告，可選合規、募資簡報、SaaS、電商、房地產、在地、競品卡、盡職調查、金融科技等範本
  • 查詢報告狀態（排隊中、執行中、已完成、失敗），並取消排隊中或進行中的報告
  • 取得已完成報告的完整 Markdown 內容與各章節
  • 檢視溯源資訊：使用的 AI 模型、代理、來源數量與內容雜湊，以及每個引用來源的連結健康統計
  • 列出近期報告，並查看剩餘額度與方案
適用情境
適合請助理研究某個市場或梳理法規環境，並交付有引用來源、附稽核紀錄的成文報告，而非零散的網頁回答。適合已有 RaportAgent 帳號、使用 Claude Desktop、Claude Code 或 Cursor 的使用者。
執行需求
透過 npx 從 npm 套件 @raportagent/mcp 以 stdio 在本機執行，需要 Node.js。需要 RaportAgent API 金鑰，放在 RAPORTAGENT_API_KEY（於 My account 的 API keys 建立）。RAPORTAGENT_BASE_URL 可覆寫預設 API 位址。需要能連線至 RaportAgent API 的網路。
安裝前請注意
產生報告會消耗 RaportAgent 額度（每份 1 點，battlecard 為 2 點），即依方案計費。API 金鑰是正式憑證，會傳送至所設定的基礎位址；請勿放入共用設定，覆寫 RAPORTAGENT_BASE_URL 時需謹慎。產生通常約需 15 分鐘，取消報告可退還額度。研究查詢與結果會傳送至 RaportAgent 服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Raportagent Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

RaportAgent MCP server

A Model Context Protocol server that puts RaportAgent inside any MCP client — Claude Desktop, Claude Code, Cursor. Ask your assistant to research a market or map a regulatory landscape, and it generates a sourced RaportAgent report, then pulls the finished markdown and its audit trail.

Thin wrapper over the RaportAgent REST API (/v1), so it inherits per-key rate limits, the credit model, and the audit trail unchanged.

Tools

ToolWhat it does
generate_reportStart a report (query, optional template: compliance/pitch/saas/ecommerce/realestate/local/battlecard/duediligence/fintech). Returns a report_id; optionally polls with wait_seconds. Costs 1 credit (2 for battlecard).
get_report_statusqueued / running / completed / failed
get_reportThe finished report's full markdown + sections
get_report_auditProvenance: AI models, agents, source counts, SHA-256 of the exact content
get_report_sourcesEvery cited source with link-health counts (working / uncertain / dead)
cancel_reportCancel a queued/in-progress report and refund its credit
list_reportsYour recent reports
get_accountRemaining credits and plan

Setup

  1. Get an API key: RaportAgent → My account → API keys (an ra_live_… key).
  2. Register it with your MCP client — no clone, no build, npx pulls the published package.

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

Claude Code

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

Cursor

Same command/args/env shape as Claude Desktop above, under Cursor's MCP settings.

Running from source (contributing / debugging only)

bash
git clone https://github.com/raportagent/raportagent-mcp.gitcd mcp-servernpm installnpm run build

Then point command/args at node / dist/index.js with an absolute path instead of npx.

Config

EnvDefaultNotes
RAPORTAGENT_API_KEY—Required. ra_live_… key.
RAPORTAGENT_BASE_URLhttps://raportagent.comOverride for self-hosted / staging.

Notes

  • Generation typically takes ~15 minutes. generate_report returns immediately with a report_id; the assistant should poll get_report_status (or pass wait_seconds) before get_report.
  • stdout is the MCP transport — the server logs only to stderr.
  • The API key is only ever sent to your configured RAPORTAGENT_BASE_URL.

來源：README.md，提交 63102ce

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分