🚀 上下文银行MCP

上下文银行MCP基于模型上下文协议（MCP）构建，旨在打造一个查询AtherOS知识库的API接口。它搭建了MCP服务器，可与Onyx API交互，创建聊天会话并向知识库发送查询。

🚀 快速开始

上下文银行MCP是一个强大的工具，能帮助你便捷地查询AtherOS知识库。按照以下步骤操作，即可快速开启使用之旅。

✨ 主要特性

• 🔍 创建新的聊天会话以查询知识库。
• 💬 发送消息到聊天会话以接收来自知识库的回答。
• 📄 格式化和显示从Onyx API获得的结果。

📦 安装指南

安装依赖

# 安装依赖
npm install

# 编译源代码
npm run build

🛠️ 配置说明

该项目借助环境变量与Onyx API建立连接，你可按需选择自动或手动设置方式。

自动设置（推荐）

运行设置脚本以交互式配置环境：

npm run setup

该脚本将完成以下操作：

1. 若.env文件不存在则创建。
2. 提示输入您的AtherOS API密钥。
3. 允许自定义API基础URL。
4. 设置其他配置选项的默认值。

手动设置

1. 复制示例环境文件以创建自己的配置：

cp .env.example .env

2. 使用具体配置编辑.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

环境变量说明

1. 必要的环境变量：
   • ONYX_API_KEY：您的AtherOS API密钥。
   • ONYX_API_BASE：AtherOS API的基础URL（例如，“http://172.30.22.52:3000”）。
2. 可选的环境变量：
   • 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许可证。