Surveymars MCP

🚀 SurveyMars MCP サーバー

SurveyMars（https://surveymars.com）では、強力な無料調査プラットフォームを通じて、ユーザーが迅速かつ簡単に洞察を収集できるようにすることを使命としています。無制限の調査、質問、回答、高度な分析ツールを備えており、技術的な専門知識や予算を必要とせずに、数分で調査を作成、配布、分析することができます。

私たちの目標は、ユーザーの時間とリソースを節約し、データ駆動型の成功を実現することに集中できるようにすることです。私たちは、ユーザーの不断に変化するニーズに応えるために、プラットフォームを継続的に改善し、最高の体験を提供することに取り組みます。

これは、公式の SurveyMars モデルコンテキストプロトコル (MCP) サーバーで、SurveyMars API との相互作用を可能にします。このサーバーを使用すると、MCP クライアント（Claude Desktop、Cursor、Windsurf、OpenAI エージェント など）が調査を作成、配布、分析することができます。

✨ 主な機能

ツール

• survey_create: SurveyMars を使用して調査を作成します。

🚀 クイックスタート

Claude Desktop 向けガイド

1. SurveyMars ログインページ から SurveyMars アカウントにログインします。
2. SurveyMars アカウント概要 で アカウント ID と シークレットキー を取得します。
3. uv（Python パッケージマネージャー）をインストールします。コマンド curl -LsSf https://astral.sh/uv/install.sh | sh を使用するか、uv リポジトリ を参照して他のインストール方法を確認してください。
4. 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 で「開発者モード」を有効にする必要があります。メニューバーの左上にあるハンバーガーアイコンをクリックし、「開発者モードを有効にする」を選択してください。

💻 使用例

基本的な使用法

Claude に以下のような質問を試してみてください。

• "ホテルの満足度調査を作成してください。"
• "車の購入過程に関する調査を作成して、顧客が購入過程の各段階（初期の調査、展示場の訪問、最終的な購入決定、購入後の満足度）における貴重な洞察を収集してください。"

🔧 技術詳細

ビルドとリリース

配布パッケージを準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. リリースバージョンをビルドします。

uv build

これにより、dist/ ディレクトリにソースコードとホイール形式のリリース版が作成されます。 3. PyPI に公開します。

uv publish

公開中は、コマンド内のプレースホルダー {GITHUB_TOKEN} をそのままにするか、環境変数を使用して GitHub トークンを設定する必要があります。