新闻详情

新闻详情

首页 / 资讯中心 / 详情

Jarvis Registry REST API 速查手册:MCP 服务器与 A2A Agent 核心端点与 Scopes 完整一览

发布时间:2026/11/16 14:00:05来源:尧图网络
Jarvis Registry REST API 速查手册:MCP 服务器与 A2A Agent 核心端点与 Scopes 完整一览
Jarvis Registry REST API 速查手册MCP 服务器与 A2A Agent 核心端点与 Scopes 完整一览【免费下载链接】jarvis-registryConnect any AI copilot or autonomous agent to your enterprise tools — through a single, secure MCP/Agent gateway with built-in identity, access control, and full observability.项目地址: https://gitcode.com/gh_mirrors/ja/jarvis-registryJarvis Registry 是连接 AI 编程助手与自主 Agent 到企业工具的 MCP/Agent 安全网关内置身份认证、访问控制ACL与全链路可观测性。本文作为一份REST API 速查手册帮你快速上手 MCP 服务器与 A2A Agent 管理的核心端点并一次性看懂 RBAC Scopes 权限体系。快速认识Jarvis Registry 网关架构Jarvis Registry 由registry注册中心 API、auth-server认证服务、MCP Gateway 代理层组成。所有管理接口统一挂载在/api/v1前缀下版本见 core/config.py 的api_version配置路由注册逻辑集中在 routers.py。调用方式很简单核心只有两类认证API 调用JWT Bearer Token放在Authorization: Bearer token请求头中控制台 UIOAuth2 登录后的 Session Cookie。没有可用令牌时可先调用个人令牌生成端点POST /api/v1/tokens/generate源码见 token_routes.py获取。MCP 服务器管理核心端点速查表MCP 服务器是 Jarvis Registry 的一等资源路由实现在 server_routes.py。方法端点作用GET/api/v1/servers列出已注册的 MCP 服务器GET/api/v1/servers/{server_id}获取单个服务器详情POST/api/v1/servers注册新 MCP 服务器PATCH/api/v1/servers/{server_id}修改服务器配置DELETE/api/v1/servers/{server_id}删除服务器POST/api/v1/servers/{server_id}/toggle启用/禁用服务器POST/api/v1/servers/{server_id}/refresh重新探测能力健康检查 工具发现GET / PATCH/api/v1/servers/{server_id}/tools查看/更新工具启用状态POST/api/v1/servers/connection触发客户端连接GET/api/v1/servers/stats全局服务器统计需system-opsMCP 连接与 OAuth 管理端点当下游 MCP 服务器需要用户级 OAuth 授权时常用端点包括源码见 oauth_router.py 与 connection_router.pyGET /api/v1/mcp/oauth/discover— 探测 OAuth 元数据GET /api/v1/mcp/{server_id}/oauth/initiate— 发起授权流程GET /api/v1/mcp/{server_path}/oauth/callback— OAuth 回调GET /api/v1/mcp/oauth/tokens/{flow_id}— 拉取授权令牌POST /api/v1/mcp/oauth/refresh/{server_id}— 刷新令牌POST /api/v1/mcp/{server_id}/reinitialize— 重连会话GET /api/v1/mcp/connection/status— 查询连接状态GET /api/v1/mcp/{server_name}/auth-values— 查看已配置的认证值代理转发层由mcp-proxy-ops/a2a-proxy-ops两个 scope 保护实际流量走/proxy/mcpgw/mcp、/proxy/server/{path}、/proxy/a2a/{path}会话清理端点为DELETE /proxy/sessions/{server_id}。A2A Agent 管理核心端点速查表A2A Agent 是 Jarvis Registry 的另一类一等资源支持 Agent Card 同步与能力发现路由实现在 agent_routes.py。方法端点作用GET/api/v1/agents列出已注册 AgentGET/api/v1/agents/{agent_id}获取 Agent 详情POST/api/v1/agents注册新 A2A AgentPATCH/api/v1/agents/{agent_id}修改 Agent 配置DELETE/api/v1/agents/{agent_id}删除 AgentPOST/api/v1/agents/{agent_id}/toggle启用/禁用 AgentPOST/api/v1/agents/{agent_id}/refresh从.well-known/agent-card.json刷新技能POST/api/v1/agents/{agent_id}/wellknown同步 Agent CardGET/api/v1/agents/{agent_id}/skills查看 Agent 技能GET/api/v1/agents/.well-known/agent-cards按 URL 获取 Agent CardA2A 协议GET/api/v1/agents/statsAgent 统计信息Scopes 权限体系角色与端点对照Scopes 是 Jarvis Registry RBAC 的核心定义在 scopes.yml设计说明见 docs/design/scopes.md。核心 scope 与对应能力如下Scope覆盖端点说明servers-readGET /servers、GET /servers/{id}、GET /servers/{id}/tools查看 MCP 服务器、工具与连接状态servers-writePOST/PATCH/DELETE /servers/**、toggle、refresh注册、修改、删除、启停、刷新servers-sharePUT /permissions/mcpServer/{id}管理 MCP 服务器 ACLagents-readGET /agents、/agents/{id}、/skills、/rating、well-known查看与发现 Agentagents-writePOST/PATCH/DELETE /agents/**、wellknown注册与管理 A2A Agentagents-sharePUT /permissions/agent/{id}管理 Agent ACLfederations-read/federations-writeGET/POST/PUT/DELETE /federations/**、/sync联邦注册表连接管理user-read/auth/me、/version、/tokens/generate、/search、/mcp/*个人账号、令牌、搜索、MCP 连接acl-read/acl-writeGET/PUT /permissions/**查看与变更资源 ACLmcp-proxy-ops/a2a-proxy-ops/proxy/mcpgw/mcp、/proxy/server/、/proxy/a2a/代理调用工具与 Agentsystem-opsGET /servers/stats、/admin/tokens全局统计与管理员令牌四个内置角色的 Scope 组合角色用户组权限范围jarvis-registry-admin全部 scope含system-opsjarvis-registry-power-user读写 共享*-share ACL无system-opsjarvis-registry-user读写资源但不可共享、不可写 ACLjarvis-registry-read-only仅 *-read 与user-read⚠️ 注意federations-read/federations-write只控制端点访问具体资源可见性仍由 ACL 二层模型过滤二者配合使用。共享与 ACL 管理端点资源级共享走通用 ACL 接口源码见 acl_routes.pyGET /api/v1/permissions/search-principals— 搜索可授权的用户/用户组GET /api/v1/permissions/{resource_type}/{resource_id}— 查看资源权限PUT /api/v1/permissions/{resource_type}/{resource_id}— 变更资源权限GET /api/v1/permissions/{resource_type}/roles— 查询角色其中resource_type支持mcpServer、agent、federation、workflow等。一个易踩的坑共享 federation 不会级联共享其下同步来的 MCP 服务器或 Agent子资源需独立授权。最小实战示例三步调用 REST API# 1. 生成个人令牌控制台登录后调用 curl -X POST $BASE/api/v1/tokens/generate \ -H Cookie: mcp_gateway_session$SESSION # 2. 列出所有 MCP 服务器 curl $BASE/api/v1/servers -H Authorization: Bearer $TOKEN # 3. 按语义搜索服务器与 Agent curl -X POST $BASE/api/v1/search \ -H Authorization: Bearer $TOKEN \ -d {query: 查询天气的 MCP 工具}完整端点清单含请求/响应示例与 OpenAPI 说明可参阅 docs/api-reference.md 与旧版接口文档 docs/registry_api.md。核心文件导航MCP 服务器路由server_routes.pyA2A Agent 路由agent_routes.py联邦注册表路由federation_routes.py路由汇总注册routers.pyScopes 与角色定义scopes.yml权限设计文档docs/design/scopes.mdAPI 完整参考docs/api-reference.md掌握以上端点与 Scopes你就能用 REST API 完成 Jarvis Registry 中 MCP 服务器与 A2A Agent 的注册、发现、共享与代理调用全流程 【免费下载链接】jarvis-registryConnect any AI copilot or autonomous agent to your enterprise tools — through a single, secure MCP/Agent gateway with built-in identity, access control, and full observability.项目地址: https://gitcode.com/gh_mirrors/ja/jarvis-registry创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/15 4:54:16

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/16 19:23:38

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/16 6:47:19

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/14 16:35:50

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/16 17:28:18

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉