ContextBase (MCP 服务器)

ContextBase – 一个用于 AI 代理、助手和应用的 Model Context Protocol (MCP) 服务器，它使用简单的 API 存储、检索和管理每个用户的上下文。

特性

• 认证系统: 使用 JWT 和 bcrypt 的安全用户认证
• 内存管理: 用于存储和检索内存数据的 API 接口
• 日志系统: 全面的用户行为日志记录
• 现代技术栈: 使用 TypeScript、Fastify、Prisma ORM 构建
• 数据库集成: PostgreSQL 用于持久化存储
• 缓存: Redis 用于高性能缓存

前提条件

• Node.js (v14 或更高版本)
• PostgreSQL
• Redis
• Docker 和 Docker Compose (可选，用于容器化部署)

安装

1. 克隆仓库

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

2. 安装依赖

   cd mcp-server
   npm install
   

3. 设置环境变量 在 mcp-server 目录下创建一个 .env 文件，并包含以下变量：

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

4. 运行数据库迁移

   npx prisma migrate dev
   

5. 启动服务器

   npm start
   

   或者使用 Docker:

   docker-compose up
   

API 接口

• 认证

  • POST /api/auth/register - 注册新用户
  • POST /api/auth/login - 登录并获取 JWT token

• 内存

  • GET /api/memory - 获取所有内存
  • POST /api/memory - 创建新的内存
  • GET /api/memory/:id - 获取特定内存
  • PUT /api/memory/:id - 更新内存
  • DELETE /api/memory/:id - 删除内存

• 日志

  • GET /api/logs - 获取用户行为日志

开发

• 在开发模式下运行:

  npm run dev
  

• 运行测试:

  npm test
  

项目结构

mcp-server/
├── prisma/              # 数据库 schema 和迁移
├── src/
│   ├── api/             # API 路由和控制器
│   ├── config/          # 配置文件
│   ├── db/              # 数据库连接 (PostgreSQL, Redis)
│   ├── middleware/      # 自定义中间件
│   ├── models/          # 数据模型
│   ├── services/        # 业务逻辑
│   ├── utils/           # 实用函数
│   └── index.ts         # 应用入口点
├── scripts/             # 辅助脚本
├── .env                 # 环境变量
└── package.json         # 依赖和脚本

许可证

本项目基于 MIT 许可证 - 详情请查看 LICENSE 文件。