上下文基础 (MCP 服务器)

上下文基础 - 一个为 AI 代理、助手和应用程序设计的模型上下文协议 (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 访问令牌

• 记忆

  • 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/              # 数据库架构和迁移文件
├── src/
│   ├── api/             # API 路由和控制器
│   ├── config/          # 配置文件
│   ├── db/              # 数据库连接 (PostgreSQL, Redis)
│   ├── middleware/      # 自定义中间件
│   ├── models/          # 数据模型
│   ├── services/        # 业务逻辑
│   ├── utils/           # 工具函数
│   └── index.ts         # 应用程序入口点
├── scripts/             # 辅助脚本
├── .env                 # 环境变量文件
└── package.json         # 依赖项和脚本

许可证

MIT