Citeassist (Citation Retrieval)

🚀 CiteAssist MCP サーバ

CiteAs と Google Scholar から BibTeX 形式の引用データを提供する Model Context Protocol (MCP) サーバです。このサーバを使用することで、あなたのアプリケーションに直接引用検索を統合し、研究作業の効率を向上させることができます。

✨ 主な機能

ツール

• get_citeas_data - CiteAs から指定されたリソースの BibTeX 形式の引用を取得します。
  • resource (文字列、必須)：DOI、URL、キーワード
• get_scholar_data - Google Scholar から BibTeX 形式の引用を取得します。
  • query (文字列、必須)：検索クエリ
  • results (整数、オプション)：結果の数（デフォルト：2）

🚀 クイックスタート

📦 インストール

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 を表示します。