What is Contextbase

ContextBase is a Model Context Protocol (MCP) server designed for AI agents, assistants, and applications. It allows for the storage, retrieval, and management of user context through a simple API.

Use cases

Use cases for ContextBase include personalized user experiences in AI applications, memory management for virtual assistants, tracking user interactions in chatbots, and maintaining user context across sessions.

How to use

To use ContextBase, clone the repository, install dependencies, set up environment variables, run database migrations, and start the server. API endpoints are provided for user authentication, memory management, and logging.

Key features

Key features include a secure authentication system using JWT and bcrypt, memory management API endpoints, comprehensive logging of user actions, a modern tech stack built with TypeScript, Fastify, and Prisma ORM, PostgreSQL for persistent storage, and Redis for high-performance caching.

Where to use

ContextBase can be used in various fields such as AI applications, virtual assistants, chatbots, and any application requiring user context management.

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