Ghostshell

🚀 Subconscious AI MCPサーバー

このサーバーは、ClaudeやCursorなどのMCP互換クライアントからAIを活用した連接実験を実行することができます。因果推論と合成母集団を利用して、人々が決定を下す理由を理解することができます。

✨ 主な機能

• 🧠 因果関係の研究 - 研究の質問を検証し、統計的に有効な実験を生成します。
• 👥 合成母集団 - 米国国勢調査のマイクロデータ（IPUMS）に基づくAIペルソナを使用して、代表的なサンプリングを行います。
• 📊 連接分析 - 属性の重要性を測定するためのAMCE（平均限界構成要素効果）を使用します。
• 🤖 MCPプロトコル - Claude Desktop、Cursor、およびその他のMCP互換AIアシスタントと連携します。
• 🌐 REST API - 統合のために直接HTTPアクセスを提供します（n8n、Zapier、カスタムアプリなど）。
• ⚡ リアルタイム更新 - 実験の進行状況をリアルタイムで提供するServer-Sent Events（SSE）をサポートします。

🚀 クイックスタート

オプション1: ホスト型サーバーを使用する（推奨）

セットアップは必要ありません！MCPクライアントの設定に追加してください。

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "subconscious-ai": {
      "url": "https://ghostshell-runi.vercel.app/api/sse?token=YOUR_TOKEN"
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "subconscious-ai": {
      "url": "https://ghostshell-runi.vercel.app/api/sse?token=YOUR_TOKEN"
    }
  }
}

🔑 トークンは app.subconscious.ai → 設定 → アクセストークン で取得できます。

オプション2: ローカルで実行する

前提条件:

• Python 3.11+
• Subconscious AIアカウントとアクセストークン

# リポジトリをクローンする
git clone https://github.com/Subconscious-ai/subconscious-ai-mcp.git
cd subconscious-ai-mcp

# 仮想環境を作成する
python3 -m venv venv
source venv/bin/activate  # Windowsの場合は: venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

# 環境変数を設定する
export AUTH0_JWT_TOKEN="your_token_here"
export API_BASE_URL="https://api.subconscious.ai"

MCP設定に追加してください。

{
  "mcpServers": {
    "subconscious-ai": {
      "command": "/absolute/path/to/venv/bin/python3",
      "args": ["/absolute/path/to/server/main.py"],
      "env": {
        "AUTH0_JWT_TOKEN": "your_token",
        "API_BASE_URL": "https://api.subconscious.ai"
      }
    }
  }
}

📋 利用可能なツール

💻 使用例

基本的な使用法

あなた: "これが因果関係の質問か確認してください: 人々が電気自動車を購入する決定に影響を与える要因は何ですか？"

AI: ✅ これは因果関係の質問です。この研究の属性を生成しましょう。

あなた: "EVの好みの研究の属性を生成してください"

AI: それぞれ4つのレベルを持つ5つの属性を生成しました:
    - 価格: $25,000 / $35,000 / $45,000 / $55,000
    - 航続距離: 200マイル / 300マイル / 400マイル / 500マイル
    ...

あなた: "EVの購入決定に関する実験を作成してください"

AI: 🚀 実験が作成されました！実行ID: abc-123-xyz
    ステータス: 処理中 (500人の合成回答者にアンケートを実施中)

あなた: "実験abc-123-xyzのステータスを確認してください"

AI: ✅ 実験が完了しました！
    - 500人の回答者にアンケートを実施
    - 分析の準備ができています

あなた: "この実験から因果関係の洞察を取得してください"

AI: 📊 主要な発見:
    - 価格が最も強い影響を与えます (-0.32 AMCE)
    - 400マイル以上の航続距離は好みを28%向上させます
    - ブランド評判は充電速度よりも重要です

🌐 REST API

HTTPを介して直接ツールを呼び出して統合することができます。

# 実験をリストする
curl -X POST https://ghostshell-runi.vercel.app/api/call/list_experiments \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"limit": 5}'

# 因果関係を確認する
curl -X POST https://ghostshell-runi.vercel.app/api/call/check_causality \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"why_prompt": "What factors influence EV purchases?"}'

# 実験を作成する
curl -X POST https://ghostshell-runi.vercel.app/api/call/create_experiment \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"why_prompt": "What factors influence EV purchases?", "confidence_level": "Reasonable"}'

# 実験結果を取得する
curl -X POST https://ghostshell-runi.vercel.app/api/call/get_experiment_results \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"run_id": "your-run-id"}'

📡 APIエンドポイント

🏗️ Vercelでのセルフホスティング

あなたの組織用に独自のインスタンスをデプロイしましょう。

# Vercel CLIをインストールする
npm i -g vercel

# クローンしてデプロイする
git clone https://github.com/Subconscious-ai/subconscious-ai-mcp.git
cd subconscious-ai-mcp
vercel --prod

Vercelダッシュボードで環境変数を設定してください。

• API_BASE_URL: https://api.subconscious.ai (またはあなたのバックエンドURL)

⚠️ ユーザーは独自のトークンを提供する必要があります - サーバーはリクエストをSubconscious AIバックエンドに転送します。

💡 機能リクエストとサポート

機能リクエストがある場合やヘルプが必要な場合は、nihar@subconscious.ai までメールでお問い合わせください。

📚 リソース

• Subconscious AIプラットフォーム - UIを介して実験を作成する
• APIドキュメント — 完全なAPIリファレンス
• MCPプロトコル - モデルコンテキストプロトコルの仕様
• 連接分析 - 方法論について学ぶ

📄 ライセンス

このソフトウェアは、有効なSubconscious AIサブスクリプションが必要です。詳細については、LICENSEファイルを参照してください。

Made with ❤️ by Subconscious AI