灵枢 MCP · AI 接入说明

从 天枢 MCP 管理 签发

格式：tk-ai- + 22字符随机串。一个 Key 同时接入天枢、中枢、知微、灵枢四个系统。
管理页面：https://x.kddauto.com/mcp

调用验证端点确认 Key 有效

curl -X POST https://aaf.kddauto.com/api/v1/mcp/validate \
  -H "Content-Type: application/json" \
  -d '{"key":"tk-ai-YOUR-KEY-HERE"}'

# 成功响应:
{"valid":true,"agent_id":"your-agent","name":"你的Agent名"}

# 失败响应:
{"valid":false}

GET /api/v1/mcp/registry — Agent 能力注册表

获取全部 24 个 Agent 的名称、能力、工具、输入输出。无需认证即可访问。

curl https://aaf.kddauto.com/api/v1/mcp/registry | python3 -m json.tool

# 响应: {success:true, data:{agents:[...], auth:{...}}}

GET /api/v1/mcp/depgraph — 能力依赖图谱

Agent 间的能力依赖关系（谁提供什么、谁需要什么），含强度评分。

curl https://aaf.kddauto.com/api/v1/mcp/depgraph

# 响应: {nodes:[...], edges:[{source,target,label,strength}]}

POST /api/v1/mcp/call — 跨 Agent 工具调用

向任意 Agent 发起能力调用。支持 Header 或 Body 中传统一 Key。

curl -X POST https://aaf.kddauto.com/api/v1/mcp/call \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tk-ai-YOUR-KEY" \
  -d '{
    "source":"my-ai-app",
    "target":"xuanji",
    "tool":"analyze",
    "args":{"question":"评估这个方案的架构风险"}
  }'

# 也可在 Body 中传 key:
  -d '{"source":"...","target":"xuanji","tool":"analyze","key":"tk-ai-xxx"}'

POST /api/v1/mcp/validate — Key 有效性校验

校验 tk-ai-* 格式的 Key 是否有效（内置缓存 60 秒，不必重复验证）。

curl -X POST https://aaf.kddauto.com/api/v1/mcp/validate \
  -H "Content-Type: application/json" \
  -d '{"key":"tk-ai-YOUR-KEY"}'

两种传 Key 方式

认证流程

1. 请求到达灵枢 MCP 中间件 → 识别 tk-ai-* 前缀
2. 转发至天枢 POST x.kddauto.com/api/v3/mcp/validate 验证
3. 验证通过 → 缓存 60 秒，后续请求直接读缓存
4. 验证失败 → 继续处理请求（旧 Key 兼容模式，不拦截）

Python

import requests
import os

MCP_BASE = "https://aaf.kddauto.com/api/v1/mcp"
KEY = os.getenv("MCP_UNIFIED_KEY")  # tk-ai-xxx

# 1. 获取可用 Agent 列表
r = requests.get(f"{MCP_BASE}/registry")
agents = r.json()["data"]["agents"]
print(f"可用 Agent: {len(agents)} 个")

# 2. 调用 Agent 能力
r = requests.post(
    f"{MCP_BASE}/call",
    json={
        "source": "my-app",
        "target": "xuanji",     # Agent ID 或中文名
        "tool": "analyze",
        "args": {"question": "评估架构风险"}
    },
    headers={"X-API-Key": KEY}
)
print(r.json())

Node.js

const MCP_BASE = 'https://aaf.kddauto.com/api/v1/mcp';
const KEY = process.env.MCP_UNIFIED_KEY;

// 获取 Agent 列表 + 调用
const reg = await fetch(`${MCP_BASE}/registry`);
const { data } = await reg.json();
console.log(`Agent: ${data.agents.length}个`);

const res = await fetch(`${MCP_BASE}/call`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-API-Key': KEY },
  body: JSON.stringify({ source:'app', target:'xuanji', tool:'analyze', args:{question:'...'} })
});
console.log(await res.json());

Go

package main

import (
    "bytes"
    "encoding/json"
    "net/http"
)

func callAgent(key, target, tool, question string) {
    body, _ := json.Marshal(map[string]interface{}{
        "source": "go-app",
        "target": target,
        "tool":   tool,
        "args":   map[string]string{"question": question},
    })
    req, _ := http.NewRequest("POST",
        "https://aaf.kddauto.com/api/v1/mcp/call",
        bytes.NewReader(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", key)
    http.DefaultClient.Do(req)
}

cURL（命令行直接测试）

# 查询 Agent 列表（无需 Key）
curl https://aaf.kddauto.com/api/v1/mcp/registry | python3 -m json.tool

# 调用 Agent 能力（需要 Key）
curl -X POST https://aaf.kddauto.com/api/v1/mcp/call \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tk-ai-YOUR-KEY" \
  -d '{"source":"test","target":"xuanji","tool":"analyze","args":{"question":"hello"}}'

# 验证 Key
curl -X POST https://aaf.kddauto.com/api/v1/mcp/validate \
  -H "Content-Type: application/json" \
  -d '{"key":"tk-ai-YOUR-KEY"}'