MCP 服务器

Crossref MCP Server

一个模型上下文协议服务器，可以通过 Crossref API 查询学术出版物，支持按标题、作者或 DOI 搜索，并返回关于学术著作的结构化元数据。

README

Crossref MCP 服务器

一个用于与 Crossref API 交互的模型上下文协议 (MCP) 服务器。

功能

按标题搜索作品
按作者搜索作品
通过 DOI 获取作品详情

安装

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

用法

该服务器提供三个主要工具：

1. 按标题搜索

在 Crossref 中按标题搜索作品：

// 示例：搜索标题中包含“quantum computing”的作品
{
  "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": "journal-article",
      "doi": "10.xxxx/xxxxx",
      "url": "https://doi.org/10.xxxx/xxxxx",
      "container": "期刊名称",
      "publisher": "出版社名称",
      "issue": "1",
      "volume": "42",
      "abstract": "这是作品的摘要（如果可用）。"
    }
    // 更多结果...
  ]
}

对于单个 DOI 查找：

{
  "status": "success",
  "query": { "doi": "10.xxxx/xxxxx" },
  "result": {
    // 如上所示的作品详情
  }
}

对于错误或无结果：

{
  "status": "error" | "no_results" | "not_found",
  "message": "错误消息" | null,
  "query": { /* 原始查询参数 */ }
}

测试

该服务器带有一个使用 Vitest 的全面测试套件。测试涵盖所有可用工具，并包括各种场景，包括成功响应、空结果和错误处理。

运行测试

npm test

测试结构

测试使用 Vitest 的模拟功能来模拟 Crossref API 响应，而无需进行实际的网络请求。测试结构包括：

模拟数据：标题搜索、作者搜索和 DOI 查找的示例响应
模拟处理程序：mcp-server-test-handlers.js 中处理程序函数的测试版本
测试用例：针对所有工具的测试，涵盖：
- 成功的 API 响应
- 空结果集
- 错误处理和网络故障

扩展测试

要添加更多测试用例：

如果需要，将新的模拟数据添加到测试文件中
在相关的 describe 块中创建其他测试用例
使用 mockFetchResponse() 辅助函数来模拟 API 响应

示例：

it("should handle a new edge case", async () => {
  // 模拟响应
  mockFetchResponse({
    // 您的示例响应数据
  });

  // 调用处理程序
  const result = await handlers.searchByTitle({ title: "example" });

  // 断言预期结果
  expect(result).toMatchObject({
    // 预期响应结构
  });
});