Anycast MCP Server

anycast-backend の MCP（Model Context Protocol）Server です。 Claude Code などの MCP クライアントから anycast API を操作し、チャンネル作成やエピソード作成を行うために使用します。

セットアップ

前提条件

• Node.js 24.13.1（mise で管理）
• anycast-backend の API キー（ak_ プレフィックス）を取得済みであること

環境変数

Claude Code への登録

.claude/settings.json に以下を追加します:

{
  "mcpServers": {
    "anycast": {
      "command": "npx",
      "args": ["-y", "anycast-mcp-server"],
      "env": {
        "ANYCAST_API_KEY": "ak_...",
        "ANYCAST_BASE_URL": "https://api.anycast.audio"
      }
    }
  }
}

提供ツール

開発

pnpm install        # 依存関係のインストール
pnpm build          # ビルド
pnpm dev            # TypeScript のウォッチビルド
pnpm test           # テスト実行
pnpm test:watch     # テストのウォッチモード
pnpm typecheck      # 型チェック

リリース

Release Please を使用してリリースを自動化しています。

Conventional Commits

コミットメッセージは Conventional Commits に準拠してください。 コミットの種別に応じてバージョンが自動決定されます。

破壊的変更がある場合はコミット本文に BREAKING CHANGE: を含めてください（major バージョンが上がります）。

リリースフロー

1. main ブランチに Conventional Commits 形式のコミットがマージされる
2. Release Please が自動で Release PR を作成（バージョン更新 + CHANGELOG 生成）
3. Release PR をレビュー・マージすると GitHub Release が作成される
4. Release イベントをトリガーに GitHub Actions が npm publish を実行する

手動リリース

通常は上記の自動フローを使用しますが、緊急時は以下の手順で手動リリースが可能です:

pnpm build
npm publish

関連リポジトリ

• anycast-backend
• anycast-frontend

License

MIT