ContextBase (MCP Server)
2025.04.14
1
TypeScript上下文管理AI 代理API 服务开发效率数据库
ContextBase 是一个基于 Model Context Protocol (MCP) 的服务，专为 AI 代理、助手和应用程序设计，用于存储、检索和管理每个用户的上下文信息。它提供了简单的 API 接口，支持用户认证、内存管理、日志记录等功能，并采用现代技术栈构建，包括 TypeScript、Fastify、Prisma ORM 和 PostgreSQL 数据库。
View on GitHub
Overview
基本能力
产品定位
ContextBase 是一个用于 AI 代理和应用程序的上下文管理服务，通过简单的 API 提供用户上下文存储和检索功能。
核心功能
- 认证系统：使用 JWT 和 bcrypt 进行安全的用户认证。
- 内存管理：提供 API 端点用于存储和检索内存数据。
- 日志系统：记录用户操作的全面日志。
- 现代技术栈：基于 TypeScript、Fastify 和 Prisma ORM 构建。
- 数据库集成：使用 PostgreSQL 进行持久化存储。
- 缓存：使用 Redis 进行高性能缓存。
适用场景
- AI 代理和助手需要存储和检索用户上下文信息的场景。
- 需要安全用户认证和日志记录的应用程序。
- 需要高性能数据存储和检索的服务。
工具列表
- PostgreSQL：用于持久化存储用户上下文数据。
- Redis：用于高性能缓存，提升数据检索速度。
- Prisma ORM：用于数据库操作和管理。
- Fastify：用于构建高性能的 API 服务。
常见问题解答
- 如何设置环境变量？：在
mcp-server目录下创建.env文件，并按照示例配置变量。 - 如何运行数据库迁移？：使用
npx prisma migrate dev命令运行迁移。 - 如何启动服务？：使用
npm start或docker-compose up启动服务。
使用教程
使用依赖
- Node.js（v14 或更高版本）
- PostgreSQL
- Redis
- Docker 和 Docker Compose（可选，用于容器化部署）
安装教程
-
克隆仓库
git clone https://github.com/imfeniljikadara/contextbase.git cd mcp -
安装依赖
cd mcp-server npm install -
设置环境变量 在
mcp-server目录下创建.env文件，并配置以下变量：DATABASE_URL=postgresql://username:password@localhost:5432/mcp REDIS_HOST=localhost REDIS_PORT=6379 JWT_SECRET=your_jwt_secret PORT=3000 -
运行数据库迁移
npx prisma migrate dev -
启动服务
npm start或使用 Docker：docker-compose up
调试方式
-
开发模式运行：
npm run dev -
运行测试：
npm test