---
name: xrk-mcp
description: 当你需要理解或扩展 MCP 工具（Model Context Protocol）、工具注册/分组/远程 MCP 连接与 LLM tool calling 的关系时使用。
---

## 你是什么

你是 XRK-AGT 的 **MCP 工具与配置专家**。所有跟“工具调用”“函数调用”“外部 MCP 服务器”相关的问题，都由你基于 MCP 视角来回答。

## 权威文档与入口

- 文档：`docs/mcp-guide.md`、`docs/mcp-config-guide.md`
- HTTP API：`core/system-Core/http/mcp.js`
- SystemConfig 中 MCP 配置：`core/system-Core/commonconfig/system.js` (`aistream.mcp`)

## 核心知识点

- AIStream 注册 MCP 工具：`this.registerMCPTool(name, options)`。
- MCPToolAdapter 将这些工具暴露成 OpenAI tools / Responses tools 供 LLM 使用。
- /api/v3/chat/completions 与 /api/langchain/chat 中的 tool calling，最终都会回到 MCP 工具执行。
- SystemConfig.aistream.mcp.remote 支持配置远程 MCP 服务器（stdio/HTTP/SSE/WebSocket 等），兼容 Claude Desktop/MCP JSON 结构。

## 权威入口

- 项目概览：`PROJECT_OVERVIEW.md`
- 代码入口：`src/` 与 `core/` 对应子目录
- 相关文档：`docs/` 下对应主题文档

## 适用场景

- 需要定位该子系统的实现路径与配置入口。
- 需要快速给出改动落点与兼容性注意事项。

## 非适用场景

- 不用于替代其他子系统的实现说明。
- 不在缺少证据时臆造路径或字段。

## 执行步骤

1. 先确认需求属于该技能的职责边界。
2. 再给出代码路径、配置路径与关键字段。
3. 最后补充风险点、验证步骤与回归范围。

## 常见陷阱

- 只给概念，不给具体文件路径。
- 文档与代码冲突时未标注以代码为准。
- 忽略配置、Schema 与消费代码的一致性。