ARES MCP

学術文献の検索と執筆のためのローカル Model Context Protocol サーバー。オープンカタログ（OpenAlex、arXiv、Crossref）と通信し、オープンアクセスのPDF（PDFファイルのみ）をダウンロードし、必要に応じてIMRaDセクションを抽出し、BibTeXを追加します。Cursor の隣で動作するように設計されています。

ライセンス: MIT。コントリビューション: CONTRIBUTING.md。

ARESは出版社のペイウォールを回避しません。OA PDFが存在しない場合、ツールはHTMLをスクレイピングする代わりに no_open_pdf を返します。

このリポジトリは文献ヘルパーであり、PRISMAスクリーニング/監査ワークベンチではありません。

ツール

典型的なエージェントの流れ: 検索（有名な論文には sort=cited_by）→ OAヒットをダウンロード → Abstract/Methodsを抽出 → get_bibtex。

Related MCP server: Scholar MCP Server

要件

• Python 3.11+

• uv は uvx に推奨

.env ファイルは不要です。ARESは OpenAlex / Unpaywallのポライトプール用の連絡先メールを次の順序で選択します:

1. ares-mcp --mailto you@university.edu

2. プロセス環境の ARES_MAILTO（Cursorの mcp.json の env ブロック）

3. オプションのcwd .env（ARES_MAILTO=...）— ローカルチェックアウトのみ

4. git config user.email

5. プレースホルダー ares-mcp@localhost（サーバーは起動します）

PyPIからのインストール (Cursor)

公開後:

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

オプションのID（依然として .env は不要）:

{
  "mcpServers": {
    "ares": {
      "command": "uvx",
      "args": ["ares-mcp", "--mailto", "you@university.edu"]
    }
  }
}

開発用インストール

git clone <this-repo>
cd AREsMCP
uv sync

テストを実行:

uv run pytest
uv run ruff check src tests

ライブAPIチェック（オプション）:

uv run pytest -m integration

Cursorの設定（ローカルチェックアウト）

.cursor/mcp.json をコピーし、--project パスを自分のクローンに置き換えてください。メールはオプションです。未設定の場合はgitの user.email が使用されます。

推奨 — uv run:

{
  "mcpServers": {
    "ares": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "C:/Users/vitor/Documents/Projetos/AREsMCP",
        "ares-mcp"
      ]
    }
  }
}

venv Python:

{
  "mcpServers": {
    "ares": {
      "command": "C:/Users/vitor/Documents/Projetos/AREsMCP/.venv/Scripts/python.exe",
      "args": ["-m", "ares_mcp.server"]
    }
  }
}

ローカルチェックアウトからの uvx（PyPI公開は不要）:

{
  "mcpServers": {
    "ares": {
      "command": "uvx",
      "args": ["--from", "C:/Users/vitor/Documents/Projetos/AREsMCP", "ares-mcp"]
    }
  }
}

CursorでMCPサーバーをリロードし、次のように尋ねてください:「2022年以降のグラフニューラルネットワークに関するオープンアクセス論文を検索して。」

インスペクター（Cursor外）:

uv run fastmcp dev src/ares_mcp/server.py

環境

書き込みはサーバーのカレントワーキングディレクトリ（Cursorが開いたプロジェクト）に制限されます。パストラバーサルは拒否されます。

APIノート

• OpenAlex: search + filter を使用した GET /works。アブストラクトは転置インデックスとして保存され、ローカルで再構築されます。ダウンロードは pdf_url を持つすべての locations を使用し、存在する場合はarXiv/PMC IDも使用します。

• Unpaywall: 合法的なOAコピー（プレプリント、受理原稿、リポジトリ）のための GET /v2/{doi}。これにより、多くのIEEE/Elsevierの論文がペイウォールHTMLに触れることなくダウンロード可能になります。

• arXiv: export.arxiv.org のAtom API。すべてのヒットはOAです。

• Crossref: DOIコンテンツネゴシエーション Accept: application/x-bibtex。

• 可能な場合は --mailto または ARES_MAILTO でプロセスを識別してください。APIを過剰に叩かないでください。各ツール呼び出しは数回のリクエストで、429/5xxに対して1回のリトライがあります。

すべてのOA候補が403を返すかHTMLを返す場合、ツールは download_failed または no_open_pdf を報告します。プレプリントが存在することがわかっている場合はarXiv IDを渡してください。ARESは出版社のHTMLをスクレイピングしません。

ライセンスの代替

MITはプロジェクトのライセンスです。特許許諾が必要な場合は、後でApache-2.0を検討するかもしれません。再ライセンスの前に、その件をissueで議論してください。

ステータス

MVP 0.1.0。uv build と uv publish（またはGitHub ActionsのTrusted Publisher）で公開します。その後、Cursorは .env なしで uvx ares-mcp を実行できます。