Crossref MCP Server

Crossref MCP サーバー

Crossref API と連携するための Model Context Protocol（MCP）サーバーです。

機能

• タイトルで文献を検索
• 著者で文献を検索
• DOI で文献の詳細を取得

インストール

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

使用方法

このサーバーは、主に次の 3 つのツールを提供します。

1. タイトルで検索

Crossref でタイトルから文献を検索します。

// Example: Search for works containing "quantum computing" in the title
{
  "title": "quantum computing",
  "rows": 5  // Optional, defaults to 5
}

2. 著者で検索

Crossref で著者から文献を検索します。

// Example: Search for works by "Einstein"
{
  "author": "Einstein",
  "rows": 5  // Optional, defaults to 5
}

3. DOI で文献を取得

DOI を使用して特定の文献を取得します。

// Example: Get work with DOI "10.1088/1742-6596/1398/1/012023"
{
  "doi": "10.1088/1742-6596/1398/1/012023"
}

レスポンス形式

すべてのレスポンスは、次の形式の構造化 JSON オブジェクトとして返されます。

検索が成功した場合：

{
  "status": "success",
  "query": {
    /* the original query parameters */
  },
  "count": 5,
  "results": [
    {
      "title": "Work title",
      "authors": [
        {
          "given": "First name",
          "family": "Last name",
          "name": "First name Last name"
        }
      ],
      "published": {
        "dateParts": [2023, 1, 15],
        "dateString": "2023-1-15"
      },
      "type": "journal-article",
      "doi": "10.xxxx/xxxxx",
      "url": "https://doi.org/10.xxxx/xxxxx",
      "container": "Journal Name",
      "publisher": "Publisher Name",
      "issue": "1",
      "volume": "42",
      "abstract": "This is the abstract of the work, if available."
    }
    // additional results...
  ]
}

DOI を 1 件検索した場合：

{
  "status": "success",
  "query": { "doi": "10.xxxx/xxxxx" },
  "result": {
    // work details as shown above
  }
}

エラーが発生した場合、または結果がない場合：

{
  "status": "error" | "no_results" | "not_found",
  "message": "Error message" | null,
  "query": { /* the original query parameters */ }
}

テスト

このサーバーには、Vitest を使用した包括的なテストスイートが用意されています。テストでは、利用可能なすべてのツールを対象に、成功したレスポンス、空の結果、エラー処理など、さまざまなシナリオを検証します。

テストの実行

npm test

テストの構成

テストでは、Vitest のモック機能を使用して Crossref API のレスポンスをシミュレートし、実際のネットワークリクエストを行わずに検証します。テストは次のように構成されています。

1. モックデータ：タイトル検索、著者検索、DOI 検索のサンプルレスポンス
2. モックハンドラー：mcp-server-test-handlers.js にあるハンドラー関数のテスト用バージョン
3. テストケース：すべてのツールを対象とした、次の項目をカバーするテスト：
   • API レスポンスの成功
   • 空の結果セット
   • エラー処理とネットワーク障害

テストの拡張

テストケースを追加するには：

1. 必要に応じてテストファイルに新しいモックデータを追加します
2. 該当する describe ブロックにテストケースを追加します
3. mockFetchResponse() ヘルパーを使用して API レスポンスをシミュレートします

例：

it("should handle a new edge case", async () => {
  // Mock the response
  mockFetchResponse({
    // Your sample response data
  });

  // Call the handler
  const result = await handlers.searchByTitle({ title: "example" });

  // Assert the expected results
  expect(result).toMatchObject({
    // Expected response structure
  });
});