PROPO MCP Server

MCP Server v0.6.0

どの AI クライアントからも PROPO のラジ活データを使う

Model Context Protocol（MCP）でフィールド・イベント・公開ガレージを検索。PROPO アカウント連携でマイガレージ・マシン会話・主催者機能も利用できます。clone や .env 設定は不要 — propo.swrc.jp の Hosted MCP に接続するだけです。

公開 20 Tools要ログイン +6計 26（Hosted）

https://propo.swrc.jp/api/mcp

概要

PROPO MCP とは

PROPO（propo.swrc.jp）が運用する MCP サーバーです。フィールド DB・イベント・公開ガレージ・レギュ要約などを、Claude Desktop / Cursor / その他 MCP 対応クライアントから呼び出せます。

2 つの接続方式

·Hosted（推奨）— https://propo.swrc.jp/api/mcp に HTTP 接続。設定不要
·Local（上級者）— リポジトリ clone + stdio。開発・Ollama・運用者向け

設計原則

·公開データは認証不要 — サーバー側で安全に提供
·個人データは PROPO ログイン + Bearer トークン
·書き込みは draft → confirm — 人間確認を経てから公開
·接続側 AI が文案・会話を生成 — 追加 LLM インフラは不要

使い方の例

今週末どこで走る？

get_nearby_this_weekend → check_entry_compliance（公開マシン or ログイン後の自分のマシン）。

レギュが読めない

summarize_regulation で平易な要約と出走前チェックリスト。

愛機と走行前相談

PROPO ログイン後、talk-with-my-machine または get_my_machine_chat_context。

主催者: 雨天連絡・告知

draft_contact_message / draft_announcement（公開イベント情報から文案生成）。

フィールド口コミの把握

summarize_spot_reviews で口コミ傾向を要約。

マシン会話

PROPO にログインし Bearer トークンを設定したうえで、ガレージ保有マシンと一人称で会話できます。返答は接続側 AI（MCP Sampling / Prompt）が生成 — PROPO 側 LLM は不要です。

·Prompt talk-with-my-machine
·get_my_machine_chat_context — systemPrompt を取得
·ask_my_machine — MCP Sampling で返答（engine=client がデフォルト）

セットアップ

1. Hosted MCP に接続

MCP クライアントの設定に URL https://propo.swrc.jp/api/mcp（Streamable HTTP）を指定。Supabase キーやリポジトリ clone は不要です。

2. 公開ツールを試す

認証なしで search_events、get_nearby_this_weekend、how_to_use などが使えます。

3. PROPO アカウント連携（任意）

マイガレージ・マシン会話には /profile/mcp でアクセストークンを取得し、Authorization: Bearer ヘッダーに設定。

4. チャットで自然文操作

「今週末、横浜近くでクローラーイベントは？」など、AI が適切な Tool を呼び出します。

Cursor（Hosted MCP）

{
  "mcpServers": {
    "propo": {
      "url": "https://propo.swrc.jp/api/mcp",
      "headers": {
        "Authorization": "Bearer <PROPO アクセストークン（任意）>"
      }
    }
  }
}

Claude Desktop（mcp-remote 経由）

{
  "mcpServers": {
    "propo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://propo.swrc.jp/api/mcp"],
      "env": {
        "AUTHORIZATION": "Bearer <PROPO アクセストークン（任意）>"
      }
    }
  }
}

ローカル自己ホスト（開発者・上級者）

CONTRIBUTOR 向け。stdio で packages/propo-mcp を起動し、任意で Ollama・Aggregator・ローカルレビューキューを使えます。

·git clone → npm run mcp:install && npm run mcp:build
·PROPO/.env.local に Supabase URL / anon key（開発用 DB）
·scripts/propo-mcp.sh を ~/.cursor/mcp.json の command に指定
·PROPO_MCP_ACCESS_TOKEN または PROPO_USER_ACCESS_TOKEN（ローカル dev のみ）

PROPO アカウント連携 → /profile/mcp

環境変数

変数	必須
Hosted MCP URL	推奨 https://propo.swrc.jp/api/mcp — 利用者側の env 不要
Authorization: Bearer	任意 PROPO ログイン後 /profile/mcp から取得。マイガレージ・会話に必要
PROPO_MCP_ACCESS_TOKEN	ローカルのみ stdio 自己ホスト時の JWT（env）
PROPO_OLLAMA_URL	ローカルのみ URL 抽出・embedding 等（自己ホスト + Ollama 利用時）
AGGREGATOR_API_TOKEN	運用者のみ Hosted 公開 MCP には含まれません

Tools 一覧

P0— 読み取り公開

search_spotsget_spotsearch_eventsget_eventget_nearby_this_weekendlist_spot_eventssearch_machinesget_public_machinehow_to_use

P1— レギュ・適合公開

summarize_regulationcheck_entry_compliance

P2— 主催文案・検索公開

draft_contact_messagedraft_announcementsearch_semantic

Auth— ログイン後要ログイン

list_my_machinesget_my_machineget_my_machine_chat_contextask_my_machinesummarize_participantscheck_spectrum_conflicts

P4— 推薦・口コミ公開

explain_why_recommendedcheck_spot_duplicatessummarize_spot_reviews

PΩ— プレビュー公開

prophesy_field_potentialsuggest_transmitter_channelreplay_field_history

Local— 自己ホスト専用自己ホスト

extract_events_from_urlqueue_extraction_from_urldraft_regulationsearch_by_embeddingdraft_hosted_eventconfirm_hosted_eventingest_aggregator_event

各 Tool のパラメータは MCP の how_to_use ツールで参照できます。

Prompts & Resources

Prompts

weekend-rc-plan今週末プラン + 適合チェック[公開]
organizer-event-draft主催イベント・告知草案[公開]
talk-with-my-machineガレージのマシンと会話[要ログイン]

Resources

propo://taxonomyカテゴリ・ジャンル定義
propo://spots/{id}フィールド JSON
propo://events/{id}イベント JSON
propo://machines/public/{id}公開マシン JSON
propo://garage/my/{id}/personaマシン会話ペルソナ

AI の使い分け

·会話・文案・要約 → 接続側 AI（Claude / Cursor 等）
·ルールベース適合・semantic フィルタ → LLM 不要
·URL 抽出・embedding → ローカル自己ホスト + Ollama（Hosted 非対応）

よくある質問

無料で使えますか？

Hosted MCP の公開ツールは無料です。AI クライアント（Claude Pro 等）の利用料は各サービスのプランに依存します。

PROPO アカウントは必要？

フィールド・イベントの読み取りは不要。マイガレージ・マシン会話・主催者向け機能にはログインと Bearer トークンが必要です。

リポジトリ clone は必要？

いいえ。通常は https://propo.swrc.jp/api/mcp への HTTP 接続のみで利用できます。clone は開発者・自己ホスト向けです。

Supabase キーを自分で設定する？

Hosted MCP では不要です。サーバー側で propo-prod に安全に接続しています。自己ホスト時のみ .env.local が必要です。

PROPO アプリの使い方はPROPOとは、FAQをご覧ください。

イベント・フィールドを探す