setlist-mcp

setlist-mcp

setlist.fm 用の MCP サーバーです。Claude から自然言語でコンサートのセットリスト、アーティスト、会場、ツアー、都市を検索できます。ほとんどは読み取り専用です（setlist.fm REST API には書き込みエンドポイントがありません）。ログイン中のセッションを使った、認証済みの「参加しました」操作も利用できます。

このプロジェクトは AI（Claude）によって開発・保守されています。ご自身の判断でご利用ください。

できること

20 個のツールを公開します。setlist.fm REST API を使った読み取り専用ツールが 18 個、認証済みの「参加しました」操作が 2 個です。

分野	ツール
アーティスト	setlist_search_artists、setlist_get_artist、setlist_get_artist_setlists
セットリスト	setlist_search_setlists、setlist_get_setlist、setlist_get_setlist_version
会場	setlist_search_venues、setlist_get_venue、setlist_get_venue_setlists
都市・国	setlist_search_cities、setlist_get_city、setlist_search_countries
ユーザー	setlist_get_user、setlist_get_user_attended、setlist_get_user_edited
解決	setlist_resolve_concerts
参加状況（認証済みの書き込み）	setlist_mark_attended、setlist_unmark_attended
ユーティリティ	setlist_healthcheck、setlist_id_from_url

セットアップ

setlist.fm/settings/api で無料の API キー（非商用利用）を取得し、.mcp.json にサーバーを追加します。

{
  "mcpServers": {
    "setlist": {
      "command": "npx",
      "args": ["-y", "setlist-mcp"],
      "env": {
        "SETLIST_API_KEY": "your-api-key-here"
      }
    }
  }
}

任意の設定：SETLIST_ACCEPT_LANGUAGE（en, es, fr, de, pt, tr, it, pl のいずれか）を指定すると、都市名と国名がローカライズされます。

参加状況ツール（setlist_mark_attended / setlist_unmark_attended）では、ログイン中の www.setlist.fm セッションが必要です。ログイン済みリクエストの Cookie ヘッダーを SETLIST_SESSION_COOKIE に設定するか、ContextMint Bridge をインストールしてください（Chrome：Chrome 用 zip を解凍して読み込みます。Safari 版はまだ利用できません。一般公開のダウンロードがない ContextMint アプリに同梱される予定のため、今のところは Chrome をご利用ください）。www.setlist.fm にログインした状態を保つと、サーバーは初回使用時にブラウザーからセッション Cookie を取得します。SETLIST_DISABLE_FETCHPROXY=1 を設定すると、ブラウザーへのフォールバックを無効にできます。

ContextMint Bridge は、同じメンテナーが新しい名前で提供する fetchproxy ブラウザー拡張機能です。fetchproxy の README からも案内されています。ソースは nullnet-app/contextmint-bridge で公開されています。ご自身でビルドするか、リリース zip と同じ場所に公開されている .sha256 ファイルを使って検証してください（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

ソースからのセットアップ、全ツールのリファレンス、使用例については、skills/setlist/SKILL.md をご覧ください。

クレジットと利用条件

利用には setlist.fm API の利用規約が適用されます。要点は次のとおりです。

• setlist.fm を明記してください。 すべての結果には url が含まれます。データを表示する箇所では、たどれるソースリンク（nofollow なし）として提示してください。ツールの説明でモデルにこの処理を指示しており、結果の url はそのまま渡されます。
• 無料キーでの利用は非商用に限られます。商用利用には setlist.fm の許可が必要です。
• 永続的なキャッシュは禁止です。 このサーバーはツールの呼び出しごとに API をリアルタイムで呼び出し、データストアを保持しません。追加しないでください。
• API キーは非公開にしてください。 キーは SETLIST_API_KEY に保存され（.env は gitignore の対象です）、ツールの出力に含まれることはありません。

開発

npm install
npm run build   # tsc + esbuild bundle → dist/
npm test        # tsc typecheck + vitest

ローカルで実行する場合は、プロジェクトのルートディレクトリに隣接する .env ファイル（gitignore の対象）に SETLIST_API_KEY=<key> を記述してください。

アーキテクチャ、規約、注意事項については CLAUDE.md をご覧ください。

License

MIT