Context Bank MCP

# 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