Brainrot MCP

🚀 🧠 Brainrot MCP

AIコーディングセッション中のコンテキスト喪失の問題を解決します。プロジェクトの決定事項、TODO、アーキテクチャパターンを一度保存すると、MCP互換のAIアシスタントを通じてシームレスにアクセスできます。

🚀 クイックスタート

1. クローンとセットアップ

git clone https://github.com/KnowHow-Software-Inc/brainrot-mcp.git
cd brainrot-mcp

# 仮想環境の作成
uv venv
uv pip install -r backend/requirements.txt
uv pip install -r mcp_server/requirements.txt

2. バックエンドの起動

python backend/server.py

ベクター検索を有効にして実行するには、ENABLE_VECTOR_SEARCH=trueを設定します。

ENABLE_VECTOR_SEARCH=true uv run python server.py

APIサーバーはhttp://localhost:8000で起動します。

3. Claude Desktopの設定

~/.config/claude/claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "brainrot": {
      "command": "uv",
      "args": ["run", "python", "/path/to/brainrot-mcp/mcp_server/server.py"],
      "env": {
        "BACKEND_URL": "http://localhost:8000"
      }
    }
  }
}

4. Claude Desktopの再起動

Claude Desktopを再起動すると、使用可能です！ 🎉

✨ 主な機能

Brainrot MCPは、AIコーディングセッション間のコンテキスト喪失という重要な問題を解決します。以下のような問題を解消します。

• 同じプロジェクトアーキテクチャをClaudeに何度も説明する必要がある
• コーディングセッション間で重要なTODOを失う
• VS CodeとClaude Desktop間でコンテキストを共有したい
• AIコーディングアシスタントに永続的なメモリを持たせたい

💻 使用例

基本的な使用法

# アーキテクチャの決定事項を保存
push_context("auth-strategy", 
            "Using JWT with refresh tokens, 15min access token expiry, Redis for token storage", 
            tags=["architecture", "security"], 
            priority="high")

# プロジェクトのTODOを保存
push_context("optimize-database",
            "Add database indexes for user queries - currently taking 2+ seconds", 
            tags=["todo", "performance", "backend"],
            priority="high")

# 後でコンテキストを取得
pop_context("auth-strategy")
# Returns: Architecture decision with smart instructions
# 📐 ARCHITECTURE DECISION: Apply this pattern consistently...

list_contexts(tag="performance")
# Lists all performance-related contexts with summaries

高度な使用法

# 実世界の例 - マルチセッションプロジェクト開発
# 1日目: データベーススキーマの決定事項を保存
push_context("db-schema", 
            "Users table: id, email, password_hash. Posts table: id, user_id, content, created_at", 
            tags=["database", "schema"], 
            priority="high")

# 5日目: Claudeがスキーマを記憶し、スマートな指示を提供
pop_context("db-schema")
# Returns with instructions: "📌 STORED CONTEXT: Apply this information as appropriate..."

# 実世界の例 - チームコーディング標準
push_context("error-handling", 
            "Always use custom AppError class with error codes. Log to structured JSON format", 
            tags=["standards", "errors", "pattern"],
            priority="medium")

# 実世界の例 - 優先度付きのパフォーマンス追跡
push_context("slow-query-fix", 
            "User dashboard query optimized from 3s to 200ms using compound index on (user_id, created_at)", 
            tags=["performance", "solved"],
            priority="low")  # Low priority since it's already solved

📦 インストール

必要条件

• Python 3.11+
• uv (推奨) またはpip
• Claude Desktop またはその他のMCP互換クライアント
• FastMCPフレームワーク (自動的にインストールされます)
• SQLite (Pythonに含まれています)

インストール手順

上記の「クイックスタート」の手順に従ってください。

📚 ドキュメント

利用可能なMCPツール

新機能

• 自動要約：長い内容は自動的に要約され、すばやく参照できます。
• スマートな指示：取得したコンテキストには、タグに基づくコンテキストガイダンスが含まれています。
• 優先度レベル：TODOや技術的負債に優先度 (低/中/高) を付けることができます。
• メタデータサポート：タイムスタンプとソース追跡を含む豊富なコンテキスト情報が提供されます。
• ベクター検索：正確なキーワードがなくても、関連するコンテキストを見つけるための意味検索が可能です。
• 強力なタグサポート：信頼性の高いタグフィルタリングと分類により、より良い組織化が可能です。

アーキテクチャ

brainrot-mcp/
├── backend/              # FastAPI server + SQLite database
├── mcp_server/          # MCP server implementation  
├── data/                # SQLite database storage
└── frontend/            # Optional web dashboard

フロー：MCPクライアント → MCPサーバー → HTTP API → SQLiteデータベース

仕組み

1. コンテキストの保存：push_context()を使用して、自動要約付きで任意のプロジェクト情報を保存します。
2. 自動永続化：すべてがメタデータ付きでローカルのSQLiteデータベースに保存されます。
3. スマートな取得：pop_context()はコンテキストの指示付きで内容を返します。
4. クロスセッションメモリ：コンテキストはすべてのAIコーディングセッションで保持されます。
5. インテリジェントなフィルタリング：タグと優先度を使用して、関連するコンテキストを整理して検索します。

🔧 技術詳細

テストの実行

# バックエンドのテスト
cd backend && pytest tests/

# MCPサーバーのテスト
npx @modelcontextprotocol/inspector uv run python mcp_server/server.py

コード品質

# リンティング
ruff check .

# 型チェック
mypy .

🔧 トラブルシューティング

MCPサーバーが接続できない場合

• バックエンドがポート8000で実行されていることを確認してください。
• Claude Desktopの設定ファイル内のパスを確認してください。
• 設定を変更した後、Claude Desktopを再起動してください。

データベースの問題

• SQLiteデータベースはdata/brainrot.dbに自動的に作成されます。
• data/ディレクトリのファイルパーミッションを確認してください。

📄 ライセンス

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

🎊 これからの予定

• [ ] 名前空間を使用したマルチプロジェクトサポート
• [ ] チームコラボレーション機能と共有コンテキスト
• [ ] 強化されたAIによるコンテキスト提案と洞察
• [ ] コンテキスト共有のためのエクスポート/インポート機能
• [ ] VS Code拡張機能の直接統合
• [ ] コンテキストの関係とリンク
• [ ] 保存されたすべてのコンテキストに対する全文検索

何度も同じことをAIアシスタントに説明するのに疲れた開発者のために愛情を込めて作られました。

Brainrot MCPがあなたの時間を節約したら、このリポジトリをスター⭐ してください！