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 用心打造 ❤️