Crossref MCP

🚀 Crossref MCP 服務器

Crossref MCP 服務器是一個用於與 Crossref API 交互的模型上下文協議 (MCP) 服務器，它能幫助用戶根據標題、作者搜索作品，還能通過 DOI 獲取作品詳細信息。

✨ 主要特性

• 根據標題搜索作品
• 根據作者搜索作品
• 使用 DOI 獲取作品詳細信息

📦 安裝指南

在配置文件中添加以下內容來安裝：

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

💻 使用示例

基礎用法

該服務器提供了三種主要工具，以下是具體使用示例：

1. 根據標題搜索

根據標題在 Crossref 中搜索作品：

// 示例：搜索包含 "量子計算" 在標題中的作品
{
  "title": "quantum computing",
  "rows": 5  // 可選，默認為 5
}

2. 根據作者搜索

根據作者在 Crossref 中搜索作品：

// 示例：搜索由 "Einstein" 撰寫的著作
{
  "author": "Einstein",
  "rows": 5  // 可選，默認為 5
}

3. 使用 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 交互，並獲取所需的作品信息。