Crossref MCP

🚀 Crossref MCP サーバ

Crossref API と相互作用するためのモデルコンテキストプロトコル (MCP) サーバです。

🚀 クイックスタート

Crossref MCP サーバは、Crossref API とのやり取りを容易にするためのサーバです。このサーバを使用することで、作品の検索や詳細情報の取得が可能です。

✨ 主な機能

• タイトルに基づいて作品を検索します。
• 著者に基づいて作品を検索します。
• DOI を使用して作品の詳細情報を取得します。

📦 インストール

以下の設定を行うことで、サーバをインストールできます。

{
  "mcpServers": {
    "crossref": {
      "command": "npx",
      "args": [
        "-y",
        "@botanicastudios/crossref-mcp"
      ]
    }
  }
}

💻 使用例

基本的な使用法

このサーバは、3 つの主要なツールを提供しています。

タイトルによる検索

タイトルを基に Crossref 内で作品を検索します。

// 例: タイトルに "量子計算" を含む作品を検索
{
  "title": "量子計算",
  "rows": 5  // オプション、デフォルトは 5
}

著者による検索

著者を基に Crossref 内で作品を検索します。

// 例: "Einstein" が著した作品を検索
{
  "author": "Einstein",
  "rows": 5  // オプション、デフォルトは 5
}

DOI による作品情報の取得

DOI を使用して特定の作品の情報を取得します。

// 例: DOI が "10.1088/1742-6596/1398/1/012023" の作品を取得
{
  "doi": "10.1088/1742-6596/1398/1/012023"
}

高度な使用法

このサーバからのレスポンスは、すべて構造化された JSON オブジェクトとして返されます。

検索成功時のレスポンス

{
  "status": "success",
  "query": {
    /* 元のクエリパラメータ */
  },
  "count": 5,
  "results": [
    {
      "title": "作品のタイトル",
      "authors": [
        {
          "given": "名前",
          "family": "姓",
          "name": "名前 姓"
        }
      ],
      "published": {
        "dateParts": [2023, 1, 15],
        "dateString": "2023-1-15"
      },
      "type": "ジャーナル記事",
      "doi": "10.xxxx/xxxxx",
      "url": "https://doi.org/10.xxxx/xxxxx",
      "journalTitle": "ジャーナルのタイトル",
      "volume": "巻数",
      "issue": "号数",
      "pageRange": "ページ範囲"
    }
  ]
}

DOI で単一作品を検索したときのレスポンス

{
  "status": "success",
  "result": {
    "title": "作品のタイトル",
    "authors": [
      {
        "given": "名前",
        "family": "姓",
        "name": "名前 姓"
      }
    ],
    "published": {
      "dateParts": [2023, 1, 15],
      "dateString": "2023-1-15"
    },
    "type": "ジャーナル記事",
    "doi": "10.xxxx/xxxxx",
    "url": "https://doi.org/10.xxxx/xxxxx",
    "journalTitle": "ジャーナルのタイトル",
    "volume": "巻数",
    "issue": "号数",
    "pageRange": "ページ範囲"
  }
}

エラーまたは結果がない場合のレスポンス

{
  "status": "error",
  "message": "エラーメッセージ"
}

📚 ドキュメント

テスト

テストスイートを実行するには、以下のコマンドを実行します。

npm test crossref

テスト構造

• モックデータ：crossref-mock を使用して Crossref API のレスポンスを模擬します。
• テストケース：
  • 複数の作品の検索に成功すること。
  • 単一の著者の作品の検索に成功すること。
  • DOI を使用して作品情報を取得すること。
  • 結果がないクエリを処理すること。
  • エラー状況を処理すること。

テストの拡張

新しいテストケースを追加するには、以下の手順に従ってください。

1. test/crossref.test.js ファイルに新しいテスト記述ファイルを追加します。
2. Node.js と Jest フレームワークを使用してテストケースを記述します。
3. テストスイートを実行して、新しいケースを検証します。

これらのツールと方法を使用することで、Crossref API と簡単にやり取りし、必要な作品情報を取得できます。