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

This project is licensed under the MIT License - see the LICENSE file for details.