关于 ContextBase (MCP Server)
ContextBase 是面向 AI Agent、助手和应用的 MCP 服务,可通过 API 存储、检索和管理每位用户的上下文,并提供认证、日志及数据库存储。
主要功能
- 01存储和检索用户记忆
- 02创建、更新和删除记忆
- 03JWT 身份验证
- 04用户操作日志
- 05PostgreSQL 存储与 Redis 缓存
适用场景
- 01让 AI 应用访问用户专属上下文
- 02通过 API 管理已存储的记忆
- 03查看记录的用户操作
MCP 相关
它为管理用户上下文的 AI Agent、助手和应用提供 MCP 服务。README 介绍了通过 API 端点实现记忆及账户功能。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
ContextBase(MCP 服务)
ContextBase——为 AI Agent、助手和应用提供的模型上下文协议(MCP)服务。它通过简单的 API 存储、检索和管理每位用户的上下文。
功能
- 身份验证系统:使用 JWT 和 bcrypt 安全地验证用户身份
- 记忆管理:提供用于存储和检索记忆数据的 API 端点
- 日志系统:全面记录用户操作
- 现代技术栈:基于 TypeScript、Fastify 和 Prisma ORM 构建
- 数据库集成:使用 PostgreSQL 持久化存储
- 缓存:使用 Redis 实现高性能缓存
先决条件
- 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
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/ # 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
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。