文献引用服务

提供BibTeX格式的文献引用数据,可从CiteAs和Google Scholar获取,适用于学术研究和工作流程集成。

  • by ndchikin
  • Python
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 ndchikin/reference-mcp

使用说明

CiteAssist MCP服务器

一个模型上下文协议服务器,提供来自CiteAs和Google Scholar的BibTeX格式的引文数据。通过将引文检索直接集成到您的应用程序中来增强您的研究工作流程。

组件

工具

  • get_citeas_data -从CiteAs检索指定资源的BibTeX格式引用
    • resource (字符串,必填):DOI、URL、关键字
  • get_scholar_data -从Google Scholar检索BibTeX格式的引文
    • query (字符串,必填):搜索查询
    • results (整数,可选):结果数量(默认值:2)

快速启动

安装

克劳德桌面

在MacOS上: ~/Library/Application\ Support/Claude/claude_desktop_config.json

在Windows上: %APPDATA%/Claude/claude_desktop_config.json

开发/未发布的服务器配置:

"mcpServers": {
  "reference-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/project/dir",
      "run",
      "reference-mcp"
    ]
  }
}

已发布的服务器配置:

"mcpServers": {
  "reference-mcp": {
    "command": "uvx",
    "args": [
      "reference-mcp"
    ]
  }
}

通过Smithery安装

通过以下方式自动安装Claude Desktop的参考mcp 史密瑟里:

npx -y @smithery/cli install @ndchikin/reference-mcp --client claude

发展

建筑与出版

准备分发包裹:

  1. 同步依赖关系并更新锁文件:
uv sync
  1. 构建包分发:
uv build

这将在 dist/ 目录。

  1. 发布到PyPI:
uv publish

注意:您需要通过环境变量或命令标志设置PyPI凭据:

  • 令牌: --token 或 UV_PUBLISH_TOKEN
  • 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器在stdio上运行,调试可能具有挑战性。为了达到最佳调试效果 经验,我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 npm 使用此命令:

npx @modelcontextprotocol/inspector uv --directory /path/to/project/dir run reference-mcp

启动后,检查器将显示一个URL,您可以在浏览器中访问该URL以开始调试。