功能标记与实验管理服务器

Statsig MCP服务器

用于集成Statsig特征标志、实验和配置的模型上下文协议（MCP）服务器。

⚠️ 重要：这是一个MCP服务器，通过以下方式进行通信 标准 （不是HTTP）。它旨在与Cursor或其他MCP兼容客户端一起使用。

快速开始

1.设置

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2.配置

创建一个 .env 项目根目录中的文件：

STATSIG_API_KEY=console-YOUR-API-KEY
STATSIG_BASE_URL=https://statsigapi.net/console/v1  # Optional, defaults to this

从获取API密钥 Statsig控制台.

3.本地测试服务器

python main.py

服务器将启动并等待stdio输入（这对MCP服务器来说是正常的）。按Ctrl+C停止。

用法

可用的MCP工具

服务器提供以下MCP工具：

1. list_feature_gates -列出所有可用的功能门
2. get_feature_gate_value -获取特定特征门的值
3. list_experiments -列出所有可用的实验
4. get_experiment -获取特定实验的详细信息

当MCP服务器配置正确时，这些工具可以在Cursor聊天中使用。

添加到光标

📖 看 MCP_SETUP_GUIDE.md 有关详细的设置说明和故障排除。

快速步骤

1. 打开光标MCP配置: Settings → Tools & MCP → Edit Config

2. 添加服务器配置:

{
  "mcpServers": {
    "statsig": {
      "command": "python",
      "args": ["main.py"],
      "cwd": "/path/to/statsig-mcp",
      "env": {
        "STATSIG_API_KEY": "console-YOUR-API-KEY"
      }
    }
  }
}

重要提示：

• ✅ 使用 "python main.py" （不是 uvicorn)
• ✅ 替换 /path/to/statsig-mcp 使用您的实际项目路径
• ✅ 替换 console-YOUR-API-KEY 使用您的Statsig API密钥
• ✅ 如果使用虚拟环境，请使用venv Python的完整路径： "/path/to/statsig-mcp/venv/bin/python"

使用.env文件（替代方案）

如果您更喜欢使用 .env 文件，您可以省略 env 章节：

{
  "mcpServers": {
    "statsig": {
      "command": "python",
      "args": ["main.py"],
      "cwd": "/path/to/statsig-mcp"
    }
  }
}

API密钥将自动从您的 .env 项目目录中的文件。

3. 重新启动游标:
   • 完全重新启动Cursor以加载新的MCP服务器
   • 验证它是否出现在MCP部分(Settings → Tools & MCP)

验证集成

配置后，您可以直接在Cursor聊天中使用Statsig MCP工具：

• 列出功能门
• 获取特征门值
• 列出实验
• 获取实验详细信息

测试

在游标聊天中测试

1. 打开光标聊天 （Cmd+L或Ctrl+L）

2. 测试列表实验 -键入其中之一：

   • List all experiments
   • Show me all my Statsig experiments
   • What experiments do I have?

3. 光标将自动:

   • 使用 list_experiments MCP工具
   • 在聊天中显示结果

验证MCP服务器是否正在运行

1. 检查光标MCP状态:

   • 首选 Settings → Tools & MCP
   • 验证“statsig”是否出现在列表中
   • 状态应显示为“已连接”或“正在运行”

2. 手动测试:

   复制

   python main.py
   

   • 应该没有错误地启动
   • 将显示“挂起”（等待stdio输入）-这是正常的！
   • 按Ctrl+C停止

3. 在游标聊天中测试:

   • 打开光标聊天（Cmd+L或Ctrl+L）
   • 问：“列出我所有的Statsig实验”
   • 光标应使用MCP工具并显示结果

故障排除

问题：“未找到MCP服务器”

• 验证 cwd Cursor配置中的路径正确
• 确保在需要的地方激活Python虚拟环境

问题：“聊天工具不可用”

• 添加MCP配置后重新启动游标
• 检查服务器是否已成功启动（检查日志）

问题：“403禁止”或“401未经授权”

• 验证 .env 文件正确 STATSIG_API_KEY
• 检查API密钥格式（应以 console-)
• 验证API密钥在Statsig控制台中是否具有正确的权限

需求

• Python 3.10+
• Statsig控制台API密钥

项目结构

statsig-mcp/
├── main.py                  # MCP server implementation
├── requirements.txt         # Python dependencies
├── .env                     # Environment variables (create this)
├── manifest.json            # MCP server metadata (tools documentation)
├── MCP_SETUP_GUIDE.md       # Detailed setup guide and troubleshooting
└── readme.md               # This file

与Statsig官方服务器的主要区别

为什么要使用自己的服务器？

• 使用不同的Statsig API端点
• 完全控制实施
• 自定义工具和功能
• 多产品支持（不同产品对应不同服务器）