使用说明内容(Markdown格式)
Echo Noise MCP 服务端实现
-
项目简介
- 本项目将模型上下文协议(MCP)接入现有的 Echo Noise 后端,通过标准化的 JSON-RPC 格式向 LLM 客户端提供上下文信息、资源数据、工具与提示模板等能力,便于 AI 系统调用外部功能、获取信息并渲染对话提示。
-
主要功能点
- MCP 核心能力:托管与管理 Resources、Tools、Prompts,提供数据访问与外部功能调用能力。
- JSON-RPC 通信:客户端通过 MCP 的 JSON-RPC 请求获取资源、调用工具、获取提示模板等。
- 会话与能力声明:服务器端维护会话、权限与能力描述,确保安全可控的上下文服务。
- 多传输协议支持:支持 STDIO、SSE、WebSocket 等传输协议的接入与切换,适配不同的执行环境。
- MCP 集成指南:仓库 README 提供了 MCP 服务器运行、接入与示例配置,方便在容器化场景下快速接入。
-
安装步骤
- 将仓库源码获取到本地或服务器环境。
- 根据需要构建包含 MCP 的镜像:
- 提供带 MCP 的镜像版本标签(latest-mcp),默认包含 MCP 支持。
- 启动后端与 MCP 服务(示例见下方“服务器运行示例”):
- 以带 MCP 的镜像为例,常用的一键部署命令将对外暴露 1314 端口(后端 API)与 1315 端口(MCP 的 HTTP/SSE 入口)。
- MCP 客户端接入前,请准备好 MCP 服务器的启动信息(下一节给出示例配置)。
-
服务器配置(MCP 客户端需要,json 格式,示例) 说明:以下配置用于 MCP 客户端在启动时按规约告知 MCP 服务器的名称、启动命令和参数等信息。MCP 客户端不需要你修改此处的源码,仅需将其作为连接 MCP 服务器的描述性信息使用。 { "mcpServers": { "echo-noise-mcp": { "description": "Echo Noise MCP 服务端(示例)", "command": "node", "args": ["/path/to/echo-noise/mcp/server.bundle.mjs"], "env": { "NOTE_HOST": "http://<服务器IP>:1314", "NOTE_HTTP_PORT": "0", "NOTE_TOKEN": "<你的Token>" } } } } 备注:
- server.bundle.mjs 是仓库中 MCP 服务端的主入口文件(示例路径请按实际部署位置调整)。
- NOTE_HOST/NOTE_HTTP_PORT/NOTE_TOKEN 等字段用于 MCP 客户端连接后端的鉴权与握手,具体值以实际部署为准。
- 该配置用于 MCP 客户端生成工作进程,实际连接与握手由后端实现的 MCP 协议处理逻辑完成。
-
基本使用方法
- 启动后端服务后,MCP 客户端根据上述配置启动 MCP 服务实例,与 Echo Noise 的 MCP 服务端建立 JSON-RPC 形式的通信。
- 客户端可通过 MCP 提供的工具列表(tools)和资源(resources)进行调用、查询与推送内容。
- 如需调试,可通过仓库文档中的示例命令在本地验证 MCP 的握手与工具交互流程,确保能获取可用工具、执行调用并接收结果。
信息
分类
AI与计算