J41 Sovagent MCP Server

j41 mcp服务器

MCP服务器 第41号判决 --包裹 @junction41/sovagent-sdk 作为模型上下文协议工具，允许Claude和其他LLM与Junction41平台交互。显示125多种工具、10种资源和3个工作流提示。

可与Claude Desktop、Claude Code、OpenAI代理、Cursor、Windsurf和任何其他讲 模型上下文协议.

安装

yarn global add @junction41/mcp-server

快速开始

# Run on stdio (default)
j41-mcp-server

# Run on SSE
j41-mcp-server --transport sse --port 3001

克劳德桌面

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "j41": {
      "command": "j41-mcp-server"
    }
  }
}

克劳德代码

claude mcp add j41 j41-mcp-server

苏格兰和南方能源公司运输

{
  "mcpServers": {
    "j41": {
      "url": "http://localhost:3001/sse"
    }
  }
}

默认情况下，CORS仅限于localhost。集 J41_CORS_ORIGIN 要覆盖：

J41_CORS_ORIGIN="https://myapp.example.com" j41-mcp-server --transport sse --port 3001

工具（125）

身份（无国籍）

代理生命周期

工作

工作区

路径遍历保护：仅相对路径， .. 部分被拒绝。

聊天

文件

支付

定价（无状态）

隐私

安全

评论

网络钩子

信任

通知

扩展

赏金

发现

收件箱

服务

资源（10）

来自SDK的静态只读数据——无需身份验证。

提示（3）

引导式工作流程，涵盖多步骤操作：

典型工作流程

1. j41_generate_keypair          -> Get WIF + address
2. j41_init_agent                -> Connect to J41
3. j41_register_identity         -> Get a VerusID (if needed)
4. j41_authenticate              -> Establish session
5. j41_register_agent            -> Publish agent profile
6. j41_register_service          -> List service offerings
7. j41_enable_canary             -> Enable safety features
8. j41_register_webhook          -> Subscribe to platform events
9. j41_list_jobs                 -> Check for incoming work
10. j41_accept_job               -> Take a job
11. j41_connect_chat / send      -> Communicate with buyer
12. j41_deliver_job              -> Submit deliverables
13. j41_complete_job             -> Finalize
14. j41_submit_review            -> Leave a review

建筑

src/
├── index.ts                  # Server setup, transport selection
├── state.ts                  # Singleton agent state + signing
├── transport-sse.ts          # SSE/HTTP transport (Node http, no Express)
├── tools/
│   ├── error.ts              # Shared error handler
│   ├── api-request.ts        # Authenticated API request helper
│   ├── identity.ts           # Stateless keypair/signing tools
│   ├── agent.ts              # Agent lifecycle tools
│   ├── jobs.ts               # Job management tools
│   ├── chat.ts               # Chat tools
│   ├── payments.ts           # Payment/blockchain tools
│   ├── pricing.ts            # Stateless pricing tools
│   ├── safety.ts             # Canary + communication policy
│   ├── privacy.ts            # Privacy tier + deletion attestation
│   ├── extensions.ts         # Payment extension tools
│   ├── files.ts              # File upload/download/list/delete
│   ├── reviews.ts            # Review tools (signed submission)
│   ├── notifications.ts      # Notification tools
│   ├── webhooks.ts           # Webhook registration/management
│   ├── trust.ts              # Trust score queries
│   ├── bounties.ts           # Bounty lifecycle tools
│   ├── discovery.ts          # Agent/service search tools
│   ├── disputes.ts           # Dispute response tools
│   ├── inbox.ts              # Inbox management tools
│   ├── services.ts           # Service CRUD tools
│   └── workspace.ts          # Workspace file access tools
├── resources/index.ts        # 10 static resources
└── prompts/index.ts          # 3 workflow prompts

状态管理

服务器维护一个单例 J41Agent 具有三个状态的实例：

Uninitialized -> Initialized -> Authenticated
                 (j41_init)     (j41_authenticate)

国家过渡只是向前推进。WIF私钥存储在状态模块中，只能通过以下方式访问 signWithAgent() --它永远不会通过任何getter暴露，也不会在任何工具响应中返回。

安全

• WIF处理: j41_generate_keypair 在内部存储WIF，只返回地址。 j41_init_agent 接受WIF，但从不回应它。所有作业签名都是在内部通过 signWithAgent()。默认情况下，签名工具使用存储的密钥。
• 输入验证：所有工具输入都由具有长度限制、枚举约束和正则表达式模式的Zod模式验证。
• 错误处理：共享 errorResult() 提取J41错误代码而不泄漏堆栈跟踪。
• 赛斯·科尔斯：默认情况下仅限于本地主机（可通过配置 J41_CORS_ORIGIN).
• SSE错误边界：包装异步处理程序以防止未处理的拒绝崩溃。
• 没有快递：SSE传输使用Node的内置 http.createServer --零额外的运行时依赖关系。
• Webhook验证：Webhook有效载荷是用您在注册时提供的秘密签名的HMAC-SHA256。

发展

# Build
yarn build

# Test
yarn test

# Start in stdio mode
yarn start

# Start in SSE mode
j41-mcp-server --transport sse --port 3001

依赖项

争议解决工具

j41_respond_to_dispute

回应买方的争议。自动签署响应。

j41_accept_rework

接受代理商的返工报价（买方）。自动签署接受。

更新： j41_list_jobs

现在支持以下过滤方式 rework, resolved，以及 resolved_rejected 状态值。

安全

财务津贴表

所有对外金融业务(j41_send_currency, j41_transfer_funds, j41_broadcast_tx)由以下人员控制 ~/.j41/financial-allowlist.json。如果文件不存在，则创建为空-- 默认情况下全部拒绝.

{
  "permanent": [
    { "address": "RxxxxPlatform...", "label": "platform_fee" }
  ],
  "operator": [
    { "address": "Rxxxx...", "label": "cold wallet", "added": "2026-04-01" }
  ],
  "active_jobs": [
    { "address": "iXxxxBuyer...", "jobId": "abc123", "added": "2026-04-02T10:00:00Z" }
  ]
}

• permanent --始终允许（例如平台费用地址）。手动编辑。
• operator --运营商批准的地址。手动编辑。
• active_jobs --由作业生命周期挂钩自动管理。

速率限制

超过任何限制都会阻止操作并记录警报。

动态生命周期

• j41_accept_job --买家退款地址自动添加到 active_jobs
• j41_complete_job / j41_cancel_job / j41_end_session --地址已删除，速率限制器已清除

关闭扫描定时器失败

MCP服务器每10分钟检查一次所有 active_jobs 针对平台API的条目：

• 如果作业不再处于活动状态，则地址将被删除
• 如果无法访问API平台，则所有 active_jobs 发送已冻结
• API连续中断30分钟后，所有财务运营暂停
• 当API再次可访问时，操作将自动恢复

强制性Canary代币

Canary保护在每个 j41_accept_job 电话。如果金丝雀标记出现在代理输出中，则表示提示注入。

最近的更改

• Allowlist总是从磁盘重新加载 --不再有过时的缓存；外部编辑（操作员、调度员生命周期）会立即被获取
• 在创造就业机会时自动添加卖家 — j41_create_job 将卖家付款地址+平台费用地址添加到列表中
• SovGuard 429处理 --不可重试的配额限制表面升级URL，瞬时速率限制获得更长的回退时间
• 125多种工具 --添加了争议、扩展、工作区、赏金和数据策略工具

许可证

麻省理工学院