🌌 STRATA — ユニバーサルコンテキストブリッジ

STRATA は、AIアシスタントやLLMエージェント（Claude Desktop、Cursor、Continue.dev、ChatGPT など）向けのユニバーサルコンテキストブリッジとして機能する、高性能な Model Context Protocol (MCP) サーバーです。

会話やコーディングセッションをまたいでAIモデルに永続的なメモリを提供し、Supabase PostgreSQL、全文インデックス、pgvector によるセマンティック検索を基盤としています。

⚡ 機能

• 🧠 永続コンテキストメモリ: AIエージェントは、セッションをまたいで決定事項、デザインシステム、API契約、設定、コードスニペットを保存できます。

• 🔍 インテリジェントメモリ検索: 自動的な最新性フォールバックを備えた高速な全文検索およびコンテキスト検索。

• 🚀 最新のMCP 2.0 SDK: Server-Sent Events (SSE) ストリーミングトランスポートを備えた最新の MCPServer デコレータアーキテクチャを使用して構築。

• 🗄️ Supabase & PostgreSQL: pgvectorサポートと行レベルセキュリティ（RLS）を備えた、実戦で検証済みのクラウドデータベースレイヤー。

• 🔄 シングルトン接続プーリング: 高スループット・低レイテンシのツール実行を実現するキャッシュ済みクライアントインスタンス。

• 🩺 組み込みヘルスチェック: 稼働時間モニタリングと接続ステータス用のRESTエンドポイント（/health）。

Related MCP server: memory-mcp

🛠️ 利用可能なMCPツール

🚀 クイックスタート

1. 前提条件

• Python 3.10 以上

• Supabase アカウントとプロジェクト

2. クローンと環境設定

# Clone the repository
git clone https://github.com/your-username/STRATA.git
cd STRATA

# Copy environment file and configure your keys
cp .env.example .env

.env にSupabaseの認証情報を設定します:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-supabase-service-role-key
DEFAULT_USER_ID=your-user-uuid (optional)

3. 依存関係のインストール

cd apps/api
python -m venv venv

# Activate virtual environment:
# Windows (PowerShell):
.\venv\Scripts\Activate.ps1
# macOS / Linux:
source venv/bin/activate

# Install requirements
pip install -r requirements.txt

4. データベース設定

Supabase SQL Editor で supabase_schema.sql にあるSQLスキーマを実行して、テーブル、ベクター拡張機能、全文インデックスを初期化します。

5. サーバーの起動

# From apps/api directory:
uvicorn main:app --reload --port 8000

サーバーは http://localhost:8000 で起動し、以下のエンドポイントを提供します:

• SSEエンドポイント: http://localhost:8000/sse

• メッセージエンドポイント: http://localhost:8000/messages/

• ヘルスチェック: http://localhost:8000/health

🔌 MCPクライアントへの接続

Claude Desktop

これを claude_desktop_config.json に追加します:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "strata": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cursor IDE

Cursorの設定の Features > MCP Servers で、新しいサーバーを追加します:

• 名前: STRATA

• タイプ: sse

• URL: http://localhost:8000/sse

📁 プロジェクト構造

STRATA/
├── apps/
│   └── api/                   # Python MCP Server
│       ├── main.py            # Server logic, MCPServer instance & tools
│       ├── requirements.txt   # Python dependencies
│       └── venv/              # Python virtual environment
├── .env.example               # Template environment file
├── .gitignore                 # Version control ignores
├── package.json               # Root monorepo configuration
├── supabase_schema.sql        # Database schema, pgvector, and indexes
└── README.md                  # Documentation

🛡️ ライセンス

MITライセンス。詳細は LICENSE を参照してください。

bounce-mcp