# Context Bank MCP
## Overview
Context Bank MCP is a project using the Model Context Protocol (MCP) to create an interface for querying the AtherOS knowledge base through an API. This project builds an MCP server capable of interacting with the Onyx API to create chat sessions and send queries to the knowledge base.
## Features
- Create new chat sessions to query the knowledge base
- Send messages to chat sessions to receive responses from the knowledge base
- Format and display results from the Onyx API
## Technologies Used
- TypeScript
- Node.js
- Model Context Protocol (MCP) SDK
- Zod for data validation
- Axios for HTTP requests
## Installation
```bash
# Install dependencies
npm install
# Compile source code
npm run build
```
## Configuration
The project uses environment variables to connect to the Onyx API. Follow these steps to configure your environment:
### Automatic Setup (Recommended)
Run the setup script to configure your environment interactively:
```bash
npm run setup
```
This script will:
1. Create a `.env` file if it doesn't exist
2. Prompt you for your AtherOS API key
3. Allow you to customize the API base URL
4. Set default values for other configuration options
### Manual Setup
1. Copy the example environment file to create your own:
```bash
cp .env.example .env
```
2. Edit the `.env` file with your specific configuration:
```
# 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
```
### Environment Variables
1. Required Environment Variables:
- `ONYX_API_KEY`: Your AtherOS API key
- `ONYX_API_BASE`: Base URL for the AtherOS API (e.g., "http://172.30.22.52:3000")
2. Optional Environment Variables:
- `PORT`: Port number for the server (default: 3000)
- `NODE_ENV`: Environment mode (development, production, test)
- `LOG_LEVEL`: Logging level (info, debug, error, warn)
## Usage
After compilation, you can use the command line tool:
```bash
# Direct usage
./build/index.js
# Or through npm
npm start
```
## API Tools
The project provides two main MCP tools:
### 1. create_chat_session
Creates a new chat session to query the knowledge base.
Parameters:
- `persona_id` (default: 0): User ID
- `description` (default: ""): Chat session description
### 2. query_atheros
Sends a message to the chat session to query the AtherOS knowledge base.
Parameters:
- `chat_session_id`: Chat session ID
- `message`: Message content
- `parent_message_id`: Parent message ID (can be null)
## Response Format
Responses from knowledge base queries include:
- Message ID
- Message content
- Rephrased query (if available)
- Information about top source documents (if available):
- Document name
- Relevance score
- Link to the document
## Architecture
The project is organized with a simple structure:
- `src/index.ts`: Main entry point of the application, defines the MCP tools and connection logic
- Uses the stdio protocol to communicate with the MCP server
## Development
```bash
# Compile and view changes
npm run build
# Run in development mode
npm run dev
```
## License
ISC
