JinDaGe - surveymars-mcp MCP Details

article

README

🚀 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 令牌。

surveymars-mcp