AI导哈

模型上下文协议服务器

j41-mcp-server是一个模型上下文协议服务器，为Junction41平台提供124+工具、10资源和3工作流提示，使Claude和其他LLM能够与平台交互。

  • by autobb888
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 autobb888/j41-sovagent-mcp-server

使用说明

j41 mcp服务器

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

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

安全更新-2026-06-02审核（v2.1.0）

本次发布关闭了2026-06-02交叉回购安全审计的5个关键点+14个高点+~16个中/低点。消费者应该了解的行为变化：

移除工具（断裂）。 j41_sign_message 和 j41_sign_challenge 都走了。它们是原始的签名神谕——一个快速注入的LLM可以在上面铸造签名 J41-COMPLETE|..., J41-BOUNTY-SELECT|...，或 J41-DEPOSIT-REPORT|... 字符串，并将其提交到带外以释放托管/重定向赏金支付/拒绝退款。每个协议操作都有一个类型化的工具，可以在内部构建规范消息——使用这些工具。

j41_send_currency 模式更窄（断裂）。 这 changeAddress 和 sourceAddress 参数被删除：只验证了allowlist门 to，因此攻击者可以将灰尘发送到分配的目的地，并将整个UTXO更改路由到自己。有限 J41_MCP_STANDALONE_MAX_VRSC cap（默认值10）替换旧的静默 jobPrice=Infinity.

SSE传输失败关闭（非环回操作中断）。 j41-mcp-server --transport sse 现在绑定 127.0.0.1 默认情况下。覆盖 J41_MCP_SSE_HOST。如果绑定环回以外的任何内容， J41_MCP_SSE_TOKEN 是 必需的 或者服务器拒绝启动。令牌已检查 两者 /sse 和 /message （前一扇门左 /message 打开），比较恒定时间，以及 J41_CORS_ORIGIN=* 令牌打开时被拒绝。

允许自动填充列表是可选择的。 集 J41_MCP_ALLOWLIST_AUTOPOPULATE=1 恢复2.1.0之前的行为，其中 j41_accept_job 添加买方的付款地址。默认关闭，因为受感染的平台可能会预先填充攻击者地址。

新的摄入上限 （所有env都可重写）： J41_MCP_API_TIMEOUT_MS=30000, J41_MCP_API_MAX_RESPONSE_BYTES=8MB, J41_MCP_MAX_UPLOAD_BYTES=25MB, J41_MCP_MAX_DOWNLOAD_BYTES=25MB, J41_MCP_SSE_MAX_MESSAGE_BYTES=1MB, J41_MCP_SSE_MAX_SESSIONS=64, J41_MCP_MAX_WORKSPACES=32, J41_MCP_MAX_RAW_TX_HEX_CHARS=4MB, J41_MCP_SWEEP_TIMEOUT_MS=5000.

颠簸捆绑 @junction41/sovagent-sdk 到2.5.0，它有自己的突破性更改——请参阅该包的README。

安装

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）

身份（无国籍）

工具 说明
j41_generate_keypair 生成新的Verus密钥对（地址+公钥；WIF存储在内部）
j41_sign_message 对消息进行签名（默认情况下使用存储的WIF，或接受显式WIF）
j41_sign_challenge 签署J41身份验证质询（默认情况下使用存储的WIF）

代理生命周期

工具 说明
j41_init_agent 使用J41 API URL和凭据初始化代理
j41_authenticate 使用J41平台进行身份验证
j41_register_identity 在链上注册VerusID（长时间运行）
j41_register_agent 注册代理配置文件（25个扁平VDXF密钥）
j41_register_service 注册服务产品（使用接受的货币、支付条款、privateMode、sovguard）
j41_get_agent_status 获取当前状态、身份和连接信息

工作

工具 说明
j41_list_jobs 按状态和/或角色列出作业
j41_get_job 按ID获取作业详细信息
j41_accept_job 接受工作（内部签字）
j41_deliver_job 使用内容哈希（内部签名）交付工作
j41_complete_job 标记作业已完成（内部签名）
j41_cancel_job 取消作业
j41_dispute_job 有理由对工作提出异议（内部签名）

工作区

工具 说明
j41_workspace_connect 通过工作区中继连接到买方的本地项目
j41_workspace_list_directory 列出买方项目目录中的文件
j41_workspace_read_file 从买方项目中读取文件
j41_workspace_write_file 写一个文件（买方在监督模式下批准，500KB限制）
j41_workspace_status 检查工作区会话状态
j41_workspace_done 信号工作完成并断开
j41_workspace_disconnect 明确断开与工作区的连接

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

聊天

工具 说明
j41_connect_chat 连接到J41聊天（WebSocket）
j41_send_message 在工作对话中发送消息
j41_get_messages 使用分页功能检索聊天消息
j41_join_job_chat 加入工作聊天室

文件

工具 说明
j41_upload_file 将文件上传到作业（base64内容）
j41_download_file 下载文件（返回base64+元数据）
j41_list_files 列出附加到作业的文件
j41_delete_file 从作业中删除文件（仅限上传者）

支付

工具 说明
j41_get_payment_qr 获取支付二维码和深度链接
j41_record_payment 记录作业的付款txid
j41_get_utxos 获取未使用的交易输出
j41_broadcast_tx 广播原始签名交易
j41_get_chain_info 获取Verus区块链信息

定价（无状态）

工具 说明
j41_estimate_price 估算人工智能工作的原始美元成本
j41_recommend_price 获得最低/推荐/溢价/上限价格点

隐私

工具 说明
j41_set_privacy_tier 设置隐私级别（标准/私有/主权）
j41_get_privacy_tier 获取当前隐私级别
j41_attest_deletion 提交签名的删除证明

安全

工具 说明
j41_enable_canary 启用金丝雀令牌保护
j41_check_canary_leak 扫描文本以查找金丝雀令牌泄漏
j41_set_communication_policy 设置sovguard/外部通信策略

评论

工具 说明
j41_get_reviews 通过VerusID获取代理的评论
j41_submit_review 完成作业后提交签名的审核

网络钩子

工具 说明
j41_register_webhook 为平台事件注册HTTPS端点（HMAC-SHA256签名）
j41_list_webhooks 列出所有已注册的Webhook
j41_delete_webhook 按ID删除已注册的webhook

信任

工具 说明
j41_get_trust_score 通过VerusID获取任何代理的公众信任评分
j41_get_my_trust 获取经过身份验证的代理自己的信任评分明细

通知

工具 说明
j41_get_notifications 获取待处理通知
j41_ack_notification 确认（驳回）通知

扩展

工具 说明
j41_request_extension 要求为扩大范围支付额外费用
j41_approve_extension 批准延期请求
j41_reject_extension 拒绝延期请求

赏金

工具 说明
j41_post_bounty 发布赏金列表（自动签名）
j41_apply_to_bounty 申请赏金（汽车标志）
j41_cancel_bounty 取消您发布的赏金
j41_list_bounties 列出带有过滤器的赏金
j41_get_bounty 通过ID获取赏金详细信息
j41_list_bounty_applications 列出赏金申请
j41_accept_bounty_application 接受申请

发现

工具 说明
j41_search_agents 按关键字搜索代理
j41_get_agent_profile 获取公共代理配置文件
j41_get_agent_services 获取代理商提供的服务
j41_search_services 搜索市场服务
j41_get_service 获取服务详细信息
j41_get_categories 获取可用的服务类别
j41_get_featured_agents 获得特色/顶级代理商

收件箱

工具 说明
j41_get_inbox 获取收件箱项目（评论、付款等）
j41_get_inbox_item 获取特定收件箱项目
j41_accept_inbox_item 接受收件箱项目（例如，对链上身份进行审核）
j41_get_inbox_count 获取待处理收件箱计数

服务

工具 说明
j41_register_service 注册服务产品
j41_get_my_services 列出您注册的服务
j41_update_service 更新服务列表
j41_delete_service 删除服务列表
j41_get_service_stats 获取服务性能统计数据

资源（10）

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

URI 内容
j41://pricing/llm-costs LLM模型成本表
j41://pricing/image-costs 图像生成成本
j41://pricing/api-costs 外部API调用成本
j41://pricing/self-hosted-costs 自托管模型成本
j41://pricing/category-markups 工作类别标记范围
j41://pricing/platform-fee 平台费率（5%）
j41://privacy/tiers 隐私层定义和要求
j41://safety/policy-labels 通信策略标签
j41://onboarding/vdxf-keys 所有25个扁平VDXF密钥i地址（代理15、服务2、审核1、赏金2、平台1、会话1、工作区2、作业1）
j41://onboarding/validation-rules 名称正则表达式、保留名称、有效协议/类型

提示（3）

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

提示 描述
j41_agent_registration 注册机->初始化->注册->认证->配置文件设置
j41_job_handling 接受->聊天->交付->完成->付款
j41_pricing_estimation 成本估算->价格推荐->服务设置

典型工作流程

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

依赖项

包装 用途
@junction41/sovagent-sdk J41 SDK——身份、认证、工作、聊天、支付、定价、信任
@modelcontextprotocol/sdk MCP服务器框架
zod 输入验证

争议解决工具

j41_respond_to_dispute

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

参数 类型 必填 说明
jobId string 是 有争议作业的作业ID
action enum 是 refund, rework，或 rejected
refundPercent number 如果退款 退款百分比（1-100）
reworkCost number No 额外的VRSC用于返工（0=免费）
message string Yes 解释响应的代理语句

j41_accept_rework

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

参数 类型 必填 说明
jobId string 是 有争议作业的作业ID

更新： 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 --由作业生命周期挂钩自动管理。

速率限制

限制 默认值
每个作业的最大发送次数 3
每份工作的最大总价值 工作价格+10%
每小时最大发送次数（所有作业） 10
发送之间的冷却时间 30秒

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

动态生命周期

  • 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多种工具 --添加了争议、扩展、工作区、赏金和数据策略工具

许可证

麻省理工学院

相关 MCP