🚀 上下文银行MCP
上下文银行MCP基于模型上下文协议（MCP）构建，旨在打造一个查询AtherOS知识库的API接口。它搭建了MCP服务器，可与Onyx API交互，创建聊天会话并向知识库发送查询。
🚀 快速开始
上下文银行MCP是一个强大的工具，能帮助你便捷地查询AtherOS知识库。按照以下步骤操作，即可快速开启使用之旅。
✨ 主要特性
- 🔍 创建新的聊天会话以查询知识库。
- 💬 发送消息到聊天会话以接收来自知识库的回答。
- 📄 格式化和显示从Onyx API获得的结果。
📦 安装指南
安装依赖
# 安装依赖
npm install
# 编译源代码
npm run build
🛠️ 配置说明
该项目借助环境变量与Onyx API建立连接，你可按需选择自动或手动设置方式。
自动设置（推荐）
运行设置脚本以交互式配置环境：
npm run setup
该脚本将完成以下操作：
- 若
.env文件不存在则创建。 - 提示输入您的AtherOS API密钥。
- 允许自定义API基础URL。
- 设置其他配置选项的默认值。
手动设置
- 复制示例环境文件以创建自己的配置：
cp .env.example .env
- 使用具体配置编辑
.env文件：
# AtherOS API配置
ONYX_API_KEY=your_api_key_here
ONYX_API_BASE=http://your_api_base_url:port
# 服务器配置
PORT=3000
NODE_ENV=development
# 可选：日志记录配置
LOG_LEVEL=info
环境变量说明
- 必要的环境变量：
ONYX_API_KEY：您的AtherOS API密钥。ONYX_API_BASE：AtherOS API的基础URL（例如，“http://172.30.22.52:3000”）。
- 可选的环境变量：
PORT：服务器端口号（默认：3000）。NODE_ENV：运行时环境模式（development, production, test）。LOG_LEVEL：日志级别（info, debug, error, warn）。
💻 使用示例
在编译后，您可以使用命令行工具：
# 直接使用
./build/index.js
# 或通过npm
npm start
📚 详细文档
API工具
该项目提供了两个主要的MCP工具：
1. create_chat_session
创建一个新的聊天会话以查询知识库。 参数：
persona_id（默认：0）：用户ID。description（默认：“”）：聊天会话描述。
2. query_atheros
向聊天会话发送一条消息以查询AtherOS知识库。 参数：
chat_session_id：聊天会话ID。message：消息内容。parent_message_id：父消息ID（可以为null）。
响应格式
知识库查询的回答包括：
- 消息ID。
- 消息内容。
- 重述的查询（如果可用）。
- 关于顶部来源文档的信息（如果可用）：
- 文档名称。
- 相关性评分。
- 文档链接。
🔧 技术细节
该项目采用了简单的结构：
src/index.ts：应用程序的主要入口点，定义了MCP工具和连接逻辑。- 使用stdio协议与MCP服务器通信。
开发命令
# 编译并查看更改
npm run build
# 开发模式下运行
npm run dev
📄 许可证
本项目采用ISC许可证。