🚀 SurveyMars MCP 服务器
在 SurveyMars，我们致力于让用户能够借助强大的免费调查平台，快速且轻松地收集见解。平台提供无限的调查、问题、响应以及高级分析工具，用户无需任何技术专业知识，也无需预算，即可在几分钟内完成调查的创建、分发与分析。
我们的目标是帮助用户节省时间和资源，让用户专注于利用数据驱动成功的事务。我们会持续改进平台，以满足用户不断变化的需求，为用户提供最佳体验。
这是官方的 SurveyMars 模型上下文协议 (MCP) 服务器，可用于与 SurveyMars API 进行交互。该服务器支持 MCP 客户端（如 Claude Desktop、Cursor、Windsurf、OpenAI 代理 等）创建、分发和分析调查。
🚀 快速开始
快速入门指南（针对 Claude Desktop）
- 从 SurveyMars 登录页面 登录您的 SurveyMars 账户。
- 在 SurveyMars 账户概览 中获取您的
账户 ID和密钥。 - 安装
uv（Python 包管理器），使用命令curl -LsSf https://astral.sh/uv/install.sh | sh，或参考uv仓库 了解其他安装方法。 - 进入 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，添加以下内容：
{
"mcpServers": {
"surveymars-mcp": {
"command": "uvx",
"args": [
"surveymars-mcp",
"--account-id=your-account-id",
"--secret-key=your-secret-key"
]
}
}
}
⚠️ 重要提示
如果您使用的是 Windows，您需要在 Claude Desktop 中启用“开发者模式”才能使用 MCP 服务器。点击菜单栏左上角的汉堡图标，选择“启用开发者模式”。
✨ 主要特性
组件
工具
- survey_create：使用 SurveyMars 创建调查
💻 使用示例
基础用法
尝试询问 Claude：
- "帮我创建一份酒店满意度调查问卷"
- "创建一个车辆购买旅程调查，以从客户在他们整个购买过程中的每一个阶段收集有价值的见解，从他们的初步研究和展厅参观到最终购买决定和售后满意度。"
🔧 技术细节
开发
构建与发布
要准备分发包：
- 同步依赖项并更新锁定文件：
uv sync
- 构建发行版本：
uv build
这将在 dist/ 目录中创建源代码和轮格式发行版。
3. 发布到 PyPI：
uv publish
⚠️ 重要提示
在发布过程中，您需要保留命令中的占位符
{GITHUB_TOKEN}或通过环境变量设置您的 GitHub 令牌。