Ghostshell

🚀 潛意識AI MCP服務器

潛意識AI MCP服務器支持從Claude、Cursor或任何兼容MCP的客戶端運行由AI驅動的聯合實驗。藉助因果推斷和合成人群，深入瞭解人們做決策的原因。

🚀 快速開始

選項1：使用託管服務器（推薦）

無需設置！將以下配置添加到您的MCP客戶端配置文件中：

Claude桌面端 (~/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+
• 一個潛意識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"
      }
    }
  }
}

✨ 主要特性

• 🧠 因果研究 - 驗證研究問題並生成具有統計學意義的實驗
• 👥 合成人群 - 基於美國人口普查微觀數據（IPUMS）的AI角色，用於代表性抽樣
• 📊 聯合分析 - 使用AMCE（平均邊際成分效應）衡量屬性重要性
• 🤖 MCP協議 - 可與Claude桌面端、Cursor和任何兼容MCP的AI助手配合使用
• 🌐 REST API - 支持直接通過HTTP訪問，便於集成（如n8n、Zapier、自定義應用）
• ⚡ 即時更新 - 使用服務器發送事件（SSE）即時展示實驗進度

📋 可用工具

💻 使用示例

基礎用法

您："檢查這個問題是否為因果問題：哪些因素影響人們購買電動汽車的決策？"

AI：✅ 這是一個因果問題。讓我為這項研究生成屬性。

您："為電動汽車偏好研究生成屬性"

AI：生成了5個屬性，每個屬性有4個水平：
    - 價格：25,000美元 / 35,000美元 / 45,000美元 / 55,000美元
    - 續航里程：200英里 / 300英里 / 400英里 / 500英里
    ...

您："創建一個關於電動汽車購買決策的實驗"

AI：🚀 實驗已創建！運行ID：abc-123-xyz
    狀態：處理中（正在對500個合成受訪者進行調查）

您："檢查實驗abc-123-xyz的狀態"

AI：✅ 實驗已完成！
    - 已調查500名受訪者
    - 準備進行分析

您："從這個實驗中獲取因果洞察"

AI：📊 主要發現：
    - 價格的影響最大（AMCE為 -0.32）
    - 續航里程超過400英里可使偏好度提高28%
    - 品牌聲譽比充電速度更重要

高級用法

通過REST API調用工具進行集成

# 列出實驗
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）

⚠️ 重要提示

用戶必須提供自己的令牌 - 服務器會將請求代理到潛意識AI後端。

💡 功能請求與支持

如果您有功能請求或需要幫助，請發送電子郵件至 nihar@subconscious.ai

📚 資源

• 潛意識AI平臺 - 通過用戶界面創建實驗
• API文檔 — 完整的API參考
• MCP協議 - 模型上下文協議規範
• 聯合分析 - 瞭解該方法學

📄 許可證

此軟件需要有效的潛意識AI訂閱。詳情請參閱 LICENSE 文件。

由 潛意識AI 用心打造 ❤️