ContextBase (MCP Server)

ContextBase（MCP サーバー）

ContextBase – シンプルな API を使用してユーザーごとのコンテキストを保存、取得、管理する、AI エージェント、アシスタント、アプリ向けの Model Context Protocol（MCP）サーバーです。

機能

• 認証システム：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/              # 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