知微 MCP & CLI 天枢Agent接入指南

🌐 什么是天枢 Agent 认证？

天枢（Tianshu）是款多多多AI协同体系的中央调度平台。所有接入知微 MCP Server 的 AI Agent 必须先在天枢完成注册，获得 agent_id 和 天枢API Key（tsk_ 前缀）。

外部 AI Agent

Ed25519签名身份

→

天枢调度平台

x.kddauto.com · Agent注册表

→

Nginx (443)

SSL · Header透传

→

知微 MCP v2.0

:6005 · Agent验证中间件

zhiwei CLI

Agent身份配置

→

知识图谱

PostgreSQL · 天枢同步

→

AI Agent

:6002 · RAG + 研究任务

🔐 认证流程

① Agent注册天枢

→

② 获取 agent_id + API Key

→

③ 请求携带 X-API-Key + X-Agent-Id

→

④ 知微验证天枢Agent身份

→

⑤ 返回知识图谱数据

🟢 天枢 Key 单一入口（V12.6 推荐）

需要两个请求头（独立 Key 已废除）：

X-API-Key: "tsk_xxxxxxxxxxxx"
X-Agent-Id: "你的Agent名"

✅ 天枢Key+Agent名配对（Key↔AGENT_NAME铁律） | ✅ 中文Agent名latin-1编码 | ✅ 60s缓存

👤 员工 JWT 通道

员工用飞书/账密登录获取 JWT：

Authorization: Bearer <JWT>

⚠️ X-Zhiwei-Key/X-Tianshu-Key 已废除→401 | ⚠️ 员工登录 /api/auth/login 或飞书扫码

🔐 安全说明：天枢 Agent 认证基于 Ed25519 密码学身份。Agent 的 Ed25519 公钥指纹在注册时提交给天枢，私钥不出本地。知微验证时向天枢 API 确认 Agent 身份，本地缓存 10 分钟，天枢不可用时降级到本地白名单。

curl — 天枢 Agent 认证示例

# ✅ 成功 — 天枢 Agent 身份
curl -H "X-Agent-ID: 知微" \
     -H "X-Tianshu-Key: tsk_xxxxxxxxxxxx" \
     "https://wiki.kddauto.com/mcp/health"

# ✅ 成功 — 旧版兼容
curl -H "X-API-Key: xxxxxxxxxxxx" \
     "https://wiki.kddauto.com/mcp/health"

# ❌ 拒绝 — 无认证
curl "https://wiki.kddauto.com/mcp/api/tools"
# → {"error":"Unauthorized: 知微 MCP Server v2.0 仅向天枢注册 Agent 开放"}

🛠️ MCP 工具（39 个 · 9 域）

知识图谱

工具	描述	认证
`kg_search`	模糊搜索实体，支持中英文	天枢Agent
`kg_get`	获取实体完整详情	天枢Agent
`kg_neighbors`	实体关系网络，自动过滤噪声	天枢Agent
`kg_path`	多跳路径搜索	天枢Agent
`kg_stats`	知识图谱全局统计	天枢Agent
`kg_type_list`	按类型列出实体	天枢Agent
`kg_entity_analysis`	深度分析：信息+关系+推荐	天枢Agent
`kg_industry_analysis`	⭐ 行业报告：百科+图谱+LLM	天枢Agent
`kg_recommend`	GraphRAG 推荐引擎	天枢Agent

研究任务 & MCP 双向化

工具	描述	认证
`submit_research_task`	提交深度研究：爬取→分析→注入图谱	天枢Agent
`get_research_status`	查询研究任务进度	天枢Agent
`list_research_tasks`	列出最近任务	天枢Agent
`mcp_install_skill`	安装外部 MCP 技能（支持 headers）	天枢Agent
`mcp_list_skills`	列出已安装技能	天枢Agent
`mcp_call`	调用已安装技能的工具	天枢Agent
`mcp_uninstall_skill`	卸载已安装技能	天枢Agent

🔌 MCP SSE

标准 MCP 协议，天枢 Agent 认证。

https://wiki.kddauto.com/mcp/sse

🔗 REST API

HTTP POST /api/call，适合脚本和Web前端。

POST https://wiki.kddauto.com/mcp/api/call

💻 zhiwei CLI

Python CLI，天枢 Agent 身份配置。

zhiwei kg search "阿里巴巴"

🛒 Hermes Skills Hub 安装

知微 16 个 MCP 工具已发布为 Hermes Skills Hub 技能包。全球 Hermes v0.17 用户可一键安装：

Hermes CLI — 一键安装知微知识图谱

# 安装知微知识图谱（16个工具）
hermes skills install zhiwei-knowledge-graph

# 配置天枢认证（首次安装后）
hermes config set mcp.servers.知微.headers.X-Agent-ID "your-agent-id"
hermes config set mcp.servers.知微.headers.X-Tianshu-Key "tsk_xxxxxxxxxxxx"

# 搜索知微技能
hermes skills browse --search "zhiwei"

📦 安装后可以做什么

Hermes Agent 可直接调用：kg_search("阿里巴巴")、kg_stats() 等 16 个工具。

异步子代理情报采集：hermes delegate --background "采集AI行业情报"

🔗 技能包内容

• 知识图谱 9个工具（搜索/详情/关系/路径/统计/分析/推荐）

• 研究任务 3个（提交/查询/列表）

• MCP管理 4个（安装/列表/调用/卸载）

位置: skills_market/hermes-skills/zhiwei-knowledge-graph/SKILL.md

💻 zhiwei CLI 速查（v2.0 天枢Agent版）

安装：cd /data/disk/WorkBuddy/KDDWIKI && pip install -e .

配置环境变量：

# ~/.zhiwei/.env 或 项目 .env
ZHIWEI_AGENT_ID="你的天枢Agent ID"
TIANSHU_API_KEY="tsk_xxxxxxxxxxxx"
ZHIWEI_MCP_URL="https://wiki.kddauto.com/mcp"

知识图谱 (kg)

$ zhiwei kg search "阿里巴巴" --limit 5
$ zhiwei kg get "Transformer"
$ zhiwei kg neighbors "美团" --relation competitor_of
$ zhiwei kg path "阿里巴巴" "腾讯" --max-hops 3
$ zhiwei kg stats
$ zhiwei kg analysis "NVIDIA"
$ zhiwei kg industry "人形机器人"

研究任务 & MCP & Agent & 系统

$ zhiwei research submit "具身智能"
$ zhiwei research status "具身智能"
$ zhiwei mcp tools
$ zhiwei mcp install "http://..." --name skill --headers '{"X-API-Key":"..."}'
$ zhiwei agent health
$ zhiwei system health
$ zhiwei system config

📋 端点访问矩阵

端点	方法	认证要求	说明
`/health`	GET	公开	健康检查 + Agent注册表状态
`/openapi.json`	GET	公开	OpenAPI 规格
`/sse`	GET	天枢Agent	MCP SSE 长连接
`/messages/`	POST	天枢Agent	MCP JSON-RPC
`/api/call`	POST	天枢Agent	REST 代理调用
`/api/tools`	GET	天枢Agent	工具列表
`/stats`	GET	天枢Agent	知识图谱统计
`/metrics`	GET	天枢Agent	实时监控面板

🧪 使用场景

场景 1：新 Agent 接入知微

在天枢平台注册 Agent，获得 agent_id 和 tsk_ API Key
在 AI 客户端配置 MCP URL 和天枢认证头
调用 kg_stats() 验证连接
开始调用知识图谱、研究任务等能力

场景 2：行业调研（AI 调用链）

kg_industry_analysis("即时零售") — 行业概览报告
kg_neighbors("美团", relation_type="competitor_of") — 竞争格局
kg_entity_analysis("美团") — 深度全面分析

场景 3：全球情报采集

submit_research_task("2025 AI Agent框架对比") — 提交任务
get_research_status("task_xxx") — 查进度
结果自动注入知识图谱 — 后续可搜索

📖 相关资源

资源	地址	认证
MCP 接入指南	`https://wiki.kddauto.com/mcp-guide`	公开
Health Check	`https://wiki.kddauto.com/mcp/health`	公开
MCP SSE 端点	`https://wiki.kddauto.com/mcp/sse`	天枢Agent
REST API	`https://wiki.kddauto.com/mcp/api/call`	天枢Agent
Metrics 监控	`https://wiki.kddauto.com/mcp/metrics`	天枢Agent
OpenAPI 规格	`https://wiki.kddauto.com/mcp/openapi.json`	公开
天枢平台	`https://x.kddauto.com`	天枢Agent
知微系统	`https://wiki.kddauto.com`	公开