Context Bank MCP

概述

Context Bank MCP 是一个使用模型上下文协议 (MCP) 的项目，旨在创建一个通过 API 查询 AtherOS 知识库的接口。该项目构建了一个 MCP 服务器，能够与 Onyx API 交互，以创建聊天会话并向知识库发送查询。

功能特性

• 创建新的聊天会话以查询知识库
• 向聊天会话发送消息以接收来自知识库的回复
• 格式化并显示来自 Onyx API 的结果

使用的技术

• TypeScript
• Node.js
• 模型上下文协议 (MCP) SDK
• Zod 用于数据验证
• Axios 用于 HTTP 请求

安装

# 安装依赖
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