上下文银行 MCP

概述

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

特征

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

使用的技术

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

安装

# Install dependencies
npm install

# Compile source code
npm run build

配置

该项目使用环境变量连接到 Onyx API。请按照以下步骤配置您的环境：

自动设置（推荐）

运行安装脚本以交互方式配置您的环境：

npm run setup

该脚本将：

如果不存在则创建一个.env文件
提示您输入 AtherOS API 密钥
允许您自定义 API 基本 URL
设置其他配置选项的默认值

手动设置

复制示例环境文件来创建您自己的环境文件：

cp .env.example .env

使用您的特定配置编辑.env文件：

# AtherOS API Configuration
ONYX_API_KEY=your_api_key_here
ONYX_API_BASE=http://your_api_base_url:port

# Server Configuration
PORT=3000
NODE_ENV=development

# Optional: Logging Configuration
LOG_LEVEL=info

环境变量

所需的环境变量：
- ONYX_API_KEY ：您的 AtherOS API 密钥
- ONYX_API_BASE ：AtherOS API 的基本 URL（例如“ http://172.30.22.52:3000 ”）
可选环境变量：
- PORT ：服务器的端口号（默认值：3000）
- NODE_ENV ：环境模式（开发、生产、测试）
- LOG_LEVEL ：日志级别（信息、调试、错误、警告）

用法

编译完成后就可以使用命令行工具了：

# Direct usage
./build/index.js

# Or through npm
npm start

API 工具

该项目提供了两个主要的 MCP 工具：

1. 创建聊天会话

创建一个新的聊天会话来查询知识库。

参数：

persona_id （默认值：0）：用户 ID
description （默认值：“”）：聊天会话描述

2. query_atheros

向聊天会话发送消息以查询 AtherOS 知识库。

参数：

chat_session_id ：聊天会话 ID
message ：消息内容
parent_message_id ：父消息ID（可以为空）

响应格式

知识库查询的响应包括：

消息 ID
消息内容
重新表述的查询（如果有）
有关顶级源文档的信息（如果有）：
- 文档名称
- 相关性得分
- 文档链接

建筑学

该项目的结构很简单：

src/index.ts ：应用程序的主入口点，定义 MCP 工具和连接逻辑
使用 stdio 协议与 MCP 服务器通信

发展

# Compile and view changes
npm run build

# Run in development mode
npm run dev

执照

国际学习中心

Integrations