Contextbase

🚀 コンテキストベース (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