contextbase

contextbase

1
ai_chatbotdatabases

ContextBase is an MCP server that provides functionality for AI assistants to manage user-specific context efficiently through a simple API. It features secure authentication, comprehensive logging, and memory management using a modern tech stack.

ContextBase (MCP Server)

ContextBase – A Model Context Protocol (MCP) server for AI agents, assistants, and apps which store, retrieve, and manage per-user context using a simple API.

Features

  • Authentication System: Secure user authentication using JWT and bcrypt
  • Memory Management: API endpoints for storing and retrieving memory data
  • Logging System: Comprehensive logging of user actions
  • Modern Tech Stack: Built with TypeScript, Fastify, Prisma ORM
  • Database Integration: PostgreSQL for persistent storage
  • Caching: Redis for high-performance caching

Prerequisites

  • Node.js (v14 or higher)
  • PostgreSQL
  • Redis
  • Docker and Docker Compose (optional, for containerized deployment)

Installation

  1. Clone the repository

    git clone https://github.com/imfeniljikadara/contextbase.git
cd mcp

  2. Install dependencies

    cd mcp-server
npm install

  3. Set up environment variables Create a .env file in the mcp-server directory with the following variables:

    DATABASE_URL=postgresql://username:password@localhost:5432/mcp
REDIS_HOST=localhost
REDIS_PORT=6379
JWT_SECRET=your_jwt_secret
PORT=3000

  4. Run database migrations

    npx prisma migrate dev

  5. Start the server

    npm start

    Or using Docker:

    docker-compose up

API Endpoints

  • Authentication

    • POST /api/auth/register - Register a new user
    • POST /api/auth/login - Login and get JWT token

  • Memory

    • GET /api/memory - Get all memories
    • POST /api/memory - Create a new memory
    • GET /api/memory/:id - Get a specific memory
    • PUT /api/memory/:id - Update a memory
    • DELETE /api/memory/:id - Delete a memory

  • Logs

    • GET /api/logs - Get user action logs

Development

  • Run in development mode:

    npm run dev

  • Run tests:

    npm test

Project Structure

mcp-server/
├── prisma/              # Database schema and migrations
├── src/
│   ├── api/             # API routes and controllers
│   ├── config/          # Configuration files
│   ├── db/              # Database connections (PostgreSQL, Redis)
│   ├── middleware/      # Custom middleware
│   ├── models/          # Data models
│   ├── services/        # Business logic
│   ├── utils/           # Utility functions
│   └── index.ts         # Application entry point
├── scripts/             # Helper scripts
├── .env                 # Environment variables
└── package.json         # Dependencies and scripts

License

MIT