Citeassist (Citation Retrieval)

🚀 CiteAssist MCP 服務器

CiteAssist MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它能夠提供來自 CiteAs 和 Google Scholar 的 BibTeX 格式引用數據。通過將引文檢索功能直接集成到您的應用程序中，可有效增強研究工作流程。

🚀 快速開始

📦 安裝指南

Claude Desktop

在不同操作系統下，配置文件的位置有所不同：

• 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 安裝

要通過 Smithery 自動安裝 reference-mcp 以供 Claude Desktop 使用，可執行以下命令：

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

✨ 主要特性

工具

🔧 技術細節

開發

構建和發佈

要準備分發包，可按以下步驟操作：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建包發行版：

uv build

這將在 dist/ 目錄中創建源代碼和輪格式發行版。 3. 發佈到 PyPI：

uv publish

⚠️ 重要提示： 您需要通過環境變量或命令行參數設置 PyPI 憑據：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

調試

由於 MCP 服務器通過 stdio 運行，調試可能具有挑戰性。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP Inspector。

您可以通過 npm 使用以下命令啟動 MCP Inspector：

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

啟動後，Inspector 會顯示一個 URL，您可以在瀏覽器中訪問以開始調試。