CiteAssist MCP Server 使用说明

项目简介

CiteAssist MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 应用提供便捷的文献引用检索功能。通过集成 CiteAs 和 Google Scholar 的数据源，该服务器允许 LLM 客户端通过标准化的 MCP 协议调用工具，获取指定文献的 BibTeX 格式引用信息，从而增强研究和写作助手等应用的能力。

主要功能点

'get_citeas_data' 工具: 从 CiteAs 服务检索指定资源的 BibTeX 格式引用数据。资源可以是 DOI、URL 或关键词。
'get_scholar_data' 工具: 从 Google Scholar 检索与查询相关的文献的 BibTeX 格式引用数据。可以指定返回结果的数量。

安装步骤

安装 'uv': 确保你的系统已安装 'uv' 包管理器。如果未安装，请参考 uv installation guide.
下载仓库代码: 从 GitHub 仓库 reference-mcp 下载源代码到本地目录，例如 '/path/to/project/dir'。

服务器配置

要将 CiteAssist MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要配置客户端的 MCP 服务器设置。以下是针对 Claude Desktop 的配置示例，你需要编辑 'claude_desktop_config.json' 文件。

找到 'claude_desktop_config.json' 文件:

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在 'mcpServers' 中添加配置: 打开 'claude_desktop_config.json' 文件，找到 'mcpServers' 部分，添加或修改 'reference-mcp' 的配置。

"mcpServers": {
  "reference-mcp": {
    "command": "uv", // 指定启动服务器的命令，这里使用 uv 包管理器
    "args": [
      "--directory",  // 指定工作目录参数
      "/path/to/project/dir", // 替换为你的项目代码实际存放路径，例如 "/Users/yourname/reference-mcp"
      "run",          // uv 的 run 命令，用于运行 Python 模块
      "reference-mcp" // 指定要运行的 Python 模块名称，对应 src/reference_mcp/server.py
    ]
  }
}

注意: 请将 '/path/to/project/dir' 替换为你本地 'reference-mcp' 仓库代码的实际存放路径。

基本使用方法

配置完成后，MCP 客户端（如 Claude Desktop）将能够连接到 CiteAssist MCP Server。你可以通过客户端指示 LLM 调用以下工具来使用引用服务：

使用 'get_citeas_data' 工具: 指示 LLM 查找特定文献的引用，例如：

"请帮我查找 DOI 为 10.1234/xxxxx 的文献引用" "获取关于 '自然语言处理' 这篇文章的 CiteAs 引用"
使用 'get_scholar_data' 工具: 指示 LLM 查找 Google Scholar 上的相关文献引用，例如：

"在 Google Scholar 上搜索关于 '深度学习' 的文献，并返回 3 篇引用" "查找关于 'Transformer 模型' 的学术论文引用"

LLM 客户端会将这些自然语言指令转换为对 MCP 服务器工具的调用，并返回 BibTeX 格式的引用数据。

关键词