Skip to main content
Glama
DoubleRange

REAL MCP

by DoubleRange

REAL MCP

通过 MCP 调用 REAL 职业。宿主 Agent 负责整体任务,REAL 提供已授权职业的判断、表达、方法与工作结果。

给 Agent 的入口

读取 service.json,访问其中的 agentEntry。该地址提供当前服务地址、指定职业、远程 MCP 和本地连接方法。按当前客户端选择连接方式,保留原有配置。

详细安装步骤、各软件配置与兼容状态:INSTALL.md。

Related MCP server: genpark-workplace-goal-to-artifact-dag-orchestrator-skill

两种连接

  • 远程 MCP:向支持 Streamable HTTP 的客户端添加 /mcp 地址。支持 OAuth 的客户端会打开 REAL 网页,用户登录并批准职业、预算与期限。

  • npx 本地连接器:客户端启动此仓库的版本化 Node.js 程序;通过 real_connect 获得网页授权链接。适用于 stdio 客户端,不需要 Python 或额外 Skill。

npx 是程序启动方式,MCP 是通信协议,两者并不冲突。本包当前通过 GitHub 版本归档分发;它不是 npm 注册表上的同名包。

安装

Node.js 20.11 或以上。把 REAL_ORIGIN 换成 service.json 的 origin:

npx --yes --package=https://github.com/DoubleRange/real-mcp/archive/refs/tags/v1.0.0.tar.gz real-mcp --url REAL_ORIGIN

命令运行后等待 MCP 客户端通过标准输入发消息,这是正常行为。--help 查看参数。Windows 可在配置里使用 npx.cmd 的实际绝对路径。

授权与工作

首次连接 → REAL 登录 → 选择职业、单次上限、总预算和期限 → 回到 Agent → real_roles → real_search → real_work。

连接和读取职业不扣积分。工作使用平台同一套报价、预算和结算规则。发现全站职业不代表获得调用权限;重新授权由用户操作。授权可在 REAL「连接授权」中撤销。

real_work 可携带宿主已经读取的文件材料;需要进一步操作时返回 requires_action。宿主只执行当前任务允许的工具操作,再通过 real_continue 回传真实结果。重试复用同一 request_key,成功结算一次。

代码范围

公开内容:Node.js stdio 连接器、工具定义、安装说明与配置示例。没有账号密钥、私人资料、职业知识库或模型配置。

本地授权凭据保存在用户目录 .real/mcp/ 中,按 REAL 服务地址隔离。可用 REAL_CONNECTOR_CONFIG 指定私有文件;不要提交凭据。

许可证

MIT,见 LICENSE。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI clients to securely inspect and edit approved code, use semantic code intelligence, run builds/tests, supervise bounded processes, inspect Git, and execute owner-approved SSH commands on engineering workstations.
    2
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables agents to break high-level business objectives into dependency-ordered sub-task graphs and then directly generate the finished deliverables, such as financial spreadsheets, executive presentations, and analytical reports. It runs as a zero-dependency Python MCP server over JSON-RPC stdio, adding deterministic authorization, role-boundary validation, and telemetry.
    7
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables compatible agents to call registered local tools and read resources through one stdio server, including harness preparation, knowledge search and document management, memory retention/recall, correction proposals, advisory decisions, tool/skill discovery, and log/source inspection.
    2
    Apache 2.0