mcpField
C
Comic Vine MCP Server

Comic Vine MCP Server

ローカル
github.com/Urlyssデータベース173 週間前に更新
リポジトリ

Comic Vine MCP Server について

Comic Vine MCP Serverは、Comic Vineのキャラクター、コミック号、シリーズ、出版社、ストーリーアークの情報をAIアシスタント向けに構造化して提供します。複数種別の検索や絞り込みに対応し、画像やリソース間の関係を含むMarkdownで結果を返します。

主な機能

  1. 01キャラクター、コミック号、シリーズ、出版社、ストーリーアークの照会
  2. 02コンテンツ種別を横断する検索
  3. 03結果の絞り込み、並べ替え、ページ分割
  4. 04レスポンス項目の選択
  5. 05画像とリソース間の関係を含むMarkdown出力

活用シーン

  1. 01キャラクターと関連情報を調べる
  2. 02シリーズのコミック号や出版社情報を確認する
  3. 03ストーリーアークを検索し関連リソースを調べる

MCP 対応

このMCPサーバーは、キャラクター、コミック号、巻、出版社、ストーリーアーク、統合検索のツールを通じてComic Vine APIの照会機能をMCPクライアントに公開します。

#comic-database#comic-vine#api-assistant

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "comic-database": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
起動コマンドnpx -y @modelcontextprotocol/inspector

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@modelcontextprotocol/inspector

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Comic Vine MCP サーバー

Comic Vine API への構造化されたアクセスを提供する Model Context Protocol（MCP）サーバーです。AI アシスタントが、会話形式でコミックに関する情報を簡単に検索、取得できます。

機能

  • 読みやすく表示しやすい、Markdown 形式の豊富なレスポンス
  • Comic Vine のリソースを幅広く網羅：
    • キャラクター
    • 号
    • 巻／シリーズ
    • 出版社
    • ストーリーアーク
  • すべてのコンテンツタイプを横断する統合検索
  • 画像や関連情報を含む詳細な情報
  • フィルタリング、ページネーション、並べ替えに対応
  • Zod スキーマ検証による型安全な API

利用可能なツール

キャラクターツール
号ツール
巻ツール

  • get-volumes：フィルタリングとページネーションを使ってコミックの巻／シリーズを一覧表示

  • get-volume：特定の巻の詳細情報を取得

    巻ツールのドキュメントを見る

出版社ツール
ストーリーアークツール
検索ツール

各ツールは以下に対応しています：

  • レスポンス内容をカスタマイズするフィールド選択
  • 大量の結果に対応するページネーション
  • 並べ替えオプション
  • さまざまな条件によるフィルタリング
  • 画像を含むリッチな Markdown 形式
  • リソース間の関連情報の表示

セットアップ

前提条件
  • Node.js 16 以降
  • npm または yarn
  • Comic Vine API キー
Comic Vine API キーの取得
  1. Comic Vine にアクセスします
  2. アカウントをお持ちでない場合は、アカウントを登録します
  3. アカウント設定を開きます
  4. API キーを申請します
  5. API キーをコピーします
インストール
  1. リポジトリをクローンします：
git clone https://github.com/urlyss/comic-database-mcp.git

cd comic-database-mcp
  1. 依存関係をインストールします：
npm install
  1. プロジェクトをビルドします：
npm run build
HTTP トランスポート用のサーバーの実行

ホットリロードを使用する開発モード：

npm run dev

本番モード：

npm start
STDIO トランスポート用のサーバーの実行

ホットリロードを使用する開発モード：

npm run stdio-dev

本番モード：

npm stdio-start
HTTP トランスポートでのテスト

サーバーをビルドして実行した後、テストできます。

MCP Inspector を使用する場合：

# Start the MCP Inspector
npx @modelcontextprotocol/inspector
  • コンソールに表示された MCP Inspector の URL をブラウザーで開きます
  • Transport Type を Streamable HTTP に変更します
  • URL を http://localhost/mcp に変更します（または、サーバーの実行に使用する URL を指定します）
  • Authentication セクションで、Bearer Token に API キーを入力します
  • Connect を選択します。利用可能なツールを確認するには、List Tools を選択します
stdio トランスポートでのテスト

サーバーをビルドして実行した後、テストできます。

サーバーは、AI アシスタントと直接統合するための stdio トランスポートをサポートしています。

MCP Inspector を使用して、stdio トランスポートをテストできます。

# Start the MCP Inspector
npx @modelcontextprotocol/inspector
  • コンソールに表示された MCP Inspector の URL にアクセスします
  • Transport Type を stdio に変更します
  • Process Path フィールドに node path/to/the/server/dist/api/stdio-index.js を入力します
  • Environment Variables セクションに以下を追加します。
    • 名前：COMIC_VINE_API_KEY
    • 値：Comic Vine API キー
  • Connect を選択します。
  • List Tools を選択して、利用可能なツールを確認します

stdio トランスポートは、特に以下の場合に便利です。

  • AI アシスタントとの直接統合
  • 自動テストとスクリプト作成
  • HTTP トランスポートが適さない環境

レスポンス形式

すべてのレスポンスは、読みやすいように Markdown 形式で整形されています。内容は以下のとおりです。

  • 正確に参照できるリソース ID
  • Markdown 構文で適切に整形された画像
  • さまざまな種類の情報をまとめた構造化セクション
  • 関連リソースへのリンク
  • リストや詳細の見やすい書式設定
トラブルシューティング
よくある問題
  1. API キーの問題
Error: Invalid API Key
  • Comic Vine API キーが正しいことを確認します
  • API キーが認証ヘッダーに正しく設定されていることを確認します
  • stdio トランスポートの場合、プロセスの起動時に API キーが環境変数として渡されていることを確認します
  1. 接続の問題
Error: ECONNREFUSED
  • HTTP トランスポートの場合：サーバーが実行中で、ポート（80）が使用されていないことを確認します
  • stdio トランスポートの場合：MCP Inspector のプロセスパスが正しいファイルを指していることを確認します
  1. 形式の問題
Error: Invalid format specified
  • リクエストに正しいフィールド名が含まれていることを確認します
  • フィールドの値が想定される型と一致していることを確認します
  • 画像フィールドの場合、URL 形式を正しく処理していることを確認します
  1. レート制限
Error: Too Many Requests
  • Comic Vine API にはレート制限があります
  • アプリケーションにリクエストのキャッシュを実装します
  • テスト時にはリクエストの間隔を空けます
サポートを受ける

GitHub でイシューを作成し、以下の情報を記載してください。

  • トランスポートの種類（HTTP または stdio）
  • 再現手順
  • 期待される動作と実際の動作

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。