altmetric-mcp

Altmetric MCP サーバー

AI エージェントが Altmetric API にアクセスし、ニュースメディア、政策文書、ソーシャルメディア、その他のオンラインプラットフォームにおける研究成果への注目度や到達範囲を追跡できるようにする Model Context Protocol（MCP）サーバーです。

Altmetric は、従来の学術論文の引用にとどまらず、一般メディアでの報道から政策文書での引用、特許での参照、ソーシャルメディアでの反応まで、研究についてどこで議論されているかを監視し、研究が現実世界に与える影響を包括的に把握できるようにします。

接続方法は2つあります。

• ホスト型サーバー（推奨） - AI クライアントから https://mcp.altmetric.com/mcp に接続し、Altmetric アカウントでサインインします。コピーや保存が必要な API キーはなく、アカウントでアクセスできる機能（Explorer、Details Page、またはその両方）のツールを自動的に利用できます。まずはこちらをお試しください。
• ローカルで実行 - 独自の API キーを使用し、stdio 経由でサーバーを自分のマシン上で実行します。オフラインで使用する場合や、キーを直接管理したい場合に適しています。詳しくは、以下の「独自の API キーを使用してローカルで実行」をご覧ください。

必要なアクセス権

このサーバーは、Altmetric の API のいずれか一方（Details Page API または Explorer API）へのアクセスがあれば動作し、利用できる API に対応したツールを提供します。Altmetric の機能を最大限に活用するには、両方の利用を強くおすすめします。それぞれに異なる質問への回答に適しているためです。

• Details Page API - DOI、PubMed ID などの識別子で検索した特定の研究成果への注目度や、期間を指定した最近の注目度の検索に対応します。
• Explorer API - Altmetric のデータベース全体および所属機関独自の研究成果を対象に、研究成果、言及、オーディエンスの属性、ジャーナルを検索、絞り込み、集計できます。

一方の API のみを利用できる場合は、その API に対応したツールのみ使用できます。各 API で利用できるツールについてはツールをご覧ください。一方の API を利用できない場合は、API アクセスをリクエストしてください。

ホスト型サーバーに接続する（推奨）

AI クライアントで Altmetric を使う最も簡単な方法は、https://mcp.altmetric.com/mcp にあるホスト型サーバーを利用することです。クライアントからこの URL に接続し、求められたら Altmetric アカウントでサインインします。クライアントはブラウザーで標準的な OAuth フローを実行するため、コピーや保存が必要な API キーはありません。アカウントでアクセスできるツールのみを利用できます。

Claude Desktop

1. Settings → Customize → Connectors を開き、Add custom connector をクリックします。
2. 名前に Altmetric と入力し、URL に https://mcp.altmetric.com/mcp を入力します。
3. Add、続いて Connect をクリックし、ブラウザーウィンドウが開いたらサインインします。

Claude に「Altmetric のツールを使って、DOI 10.1038/nature12373 の注目度スコアを調べて」と尋ねて、接続を確認します。

Claude Code

claude mcp add --transport http altmetric https://mcp.altmetric.com/mcp

次に、Claude Code 内で /mcp を実行し、altmetric を選択して認証します。サインイン用のブラウザーウィンドウが開きます。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）に追加します。

{
  "mcpServers": {
    "Altmetric": {
      "url": "https://mcp.altmetric.com/mcp"
    }
  }
}

サーバーを初めて使用するときに、Cursor でサインイン用のブラウザーが開きます。

VS Code（GitHub Copilot）

.vscode/mcp.json に追加します（VS Code 1.101 以降）。

{
  "servers": {
    "Altmetric": {
      "type": "http",
      "url": "https://mcp.altmetric.com/mcp"
    }
  }
}

コマンドパレットを開き、MCP: List Servers を実行して Altmetric を選択し、起動します。求められたらサインインします。

ChatGPT

Settings → Connectors → Advanced を開いて Developer mode をオンにします。次に Settings → Connectors → Add custom connector を開き、https://mcp.altmetric.com/mcp を入力して、OAuth サインインを完了します。有料プラン（Plus、Pro、Business、Enterprise、または Edu）が必要です。カスタムコネクターは無料プランでは利用できません。Altmetric のツールはすべて読み取り専用のため、Plus／Pro プランの読み取り専用の制限による影響はありません。

その他の MCP クライアント

OAuth を使用する Streamable HTTP トランスポートに対応したクライアントであれば接続できます。https://mcp.altmetric.com/mcp を指定してください。最初のリクエストに対して、サーバーは検出ドキュメント（/.well-known/oauth-protected-resource）を示す WWW-Authenticate ヘッダーとともに 401 を返します。クライアントはこれを使って、Altmetric Explorer に対する OAuth フローを自動的に実行します。

サインインの仕組み

ホスト型サーバーは OAuth 2.1 の リソースサーバー です。クライアントは認可サーバーである Altmetric Explorer から、mcp スコープのベアラートークンを取得します。サーバーはそのトークンをアカウントの利用権限と照合し、ユーザーに代わって Altmetric API を呼び出します。ベアラートークンがそれらの API に転送されることは決してありません。公開されるツールセットには利用権限が反映されるため、利用可能な製品に対応するツールのみが表示されます。

プロンプトの例

接続したら、自然な言葉で質問してください。使用するツールはクライアントが選択します。以下の例では、それぞれ異なるツールを使用します。

アカウントに利用権限があるツールのみが表示されるため、Explorer を使うプロンプトには機関向けアクセスが必要です。ツールセット全体は、以下のツールをご覧ください。

データソースとライセンス

すべてのツールは Altmetric 独自の API（Details Page API と Explorer API）を呼び出します。どちらも Altmetric（Digital Science）が提供するファーストパーティサービスです。このサーバーはサードパーティ API のプロキシではなく、独自にサードパーティのデータを保有することもありません。

これらの API が返すデータには、Altmetric が各サービスとの独自の契約に基づいて収集したサードパーティプラットフォーム上の注目情報が含まれます。その契約のうち 1 つにより、返されるデータの内容が異なります。Altmetric と X（旧 Twitter）のライセンス契約に基づき、X からの言及には数値識別子のみが含まれ、アカウントのハンドル名、表示名、投稿本文は、いずれのプランでも、どちらの API でも提供されません。件数、ID、集計済みのデモグラフィックデータは利用できますが、名前付きアカウント情報は利用できません。X の言及およびAltmetric API の X データをご覧ください。

それ以外のすべてのソース（ニュース媒体、ブログ、Bluesky、Reddit、ポッドキャスト、政策文書、特許）では、名前付きの情報が返されます。

独自の API キーを使ってローカルで実行する

サーバーを自分で実行したい場合（オフラインでの利用や API キーの直接管理など）は、npx を使って stdio 経由で実行してください。

前提条件

• Node.js 20.6.0 以降 — サポートが継続されている LTS リリースを推奨します（ダウンロード）
• Altmetric API の認証情報（少なくとも 1 つ。両方を推奨します。上記の「必要なアクセス権」をご覧ください）：
  • Details Page API キー — 無料プランまたは商用アクセス
  • Explorer API キー + シークレット — 機関向けアクセス

まだキーをお持ちでない場合は、API アクセスをリクエストしてください。

クイックインストール（macOS の Claude Desktop）

ターミナルでガイド付きインストーラーを実行してください。Node.js を確認し、API キーの入力を求めたうえで、Claude Desktop を自動的に設定します。

bash <(curl -fsSL https://raw.githubusercontent.com/altmetric/altmetric-mcp/main/install.sh)

または、リポジトリをクローン済みの場合：

bash install.sh

手動で設定する場合は、以下のクライアント別の手順をご覧ください。

手動設定

npx を使ってサーバーを実行するよう、MCP クライアントを設定します。利用できる API 認証情報のみを含めてください。

{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "altmetric-mcp"],
  "env": {
    "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
    "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
    "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
  }
}

claude mcp add --transport stdio altmetric-mcp \
  --env ALTMETRIC_DETAILS_API_KEY=your_details_api_key_here \
  --env ALTMETRIC_EXPLORER_API_KEY=your_explorer_api_key_here \
  --env ALTMETRIC_EXPLORER_API_SECRET=your_explorer_api_secret_here \
  -- npx -y altmetric-mcp

{
  "servers": {
    "Altmetric": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "altmetric-mcp"],
      "env": {
        "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
        "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
        "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
      }
    }
  }
}

{
  "mcpServers": {
    "Altmetric": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "altmetric-mcp"],
      "env": {
        "ALTMETRIC_DETAILS_API_KEY": "your_details_api_key_here",
        "ALTMETRIC_EXPLORER_API_KEY": "your_explorer_api_key_here",
        "ALTMETRIC_EXPLORER_API_SECRET": "your_explorer_api_secret_here"
      }
    }
  }
}

ローカルサーバーを安全にデプロイする

ローカルサーバーは MCP ホスト（Claude Desktop、Claude Code など）の子プロセスとして実行されます。機密性の高いワークフローに組み込む前に、知っておくべき点がいくつかあります。

サーバーの動作

• 2 つの Altmetric HTTP API に対する、送信 HTTPS 経由の読み取り専用プロキシです。例外は、Explorer のクエリを指定された識別子のセットに限定するため内部で使用される、Explorer の identifier_lists エンドポイントへの冪等な POST（作成または検索）です。ユーザーに表示される状態を作成せず、破壊的な操作でもありません。
• 受信ネットワークの窓口はなく、破壊的な操作もありません。
• 上流からのテキストを信頼できないものとして扱います。プロンプトインジェクションのマーカーをスキャンし、LLM に渡す要約内の疑わしい一致箇所を伏せ、未加工の値は structuredContent 経由でのみ提示します。

実施すべきこと

• **API キーは、コミット済みの .env ファイルではなく、MCP ホストの env ブロックを使って設定してください。**キーは URL のクエリ文字列に含まれるため、ベアラー認証情報と同等のものとして扱ってください。
• **ホストで許可されている場合は、権限を制限して実行してください。**サーバーに必要なのは、api.altmetric.com と www.altmetric.com への送信 HTTPS 通信のみです。ホストやコンテナランタイムが対応している場合は、$TMPDIR 外へのファイルシステム書き込みと、その他のネットワーク送信を拒否してください。
• **送信通信の許可リスト（フォワードプロキシ／DLP）の使用を検討してください。**機密データを処理する環境内でサーバーを使う場合は、Altmetric の 2 つのホストへの通信のみを許可するプロキシ経由で送信トラフィックをルーティングしてください。サーバーがほかの宛先と通信する必要はありません。
• **データ分類の境界を守ってください。**このサーバーは、ツールの引数をそのまま第三者に転送します。プロンプトに制限対象または規制対象のデータが含まれている場合、そのデータは管理境界の外に出ます。

適用される保護

• 送信 URL は https: を使用するよう検証されます。
• 上流からの応答は 20 MB および 60 s に制限されます。
• 受信するツールの引数は、合計 8 MB／文字列ごとに 64 KB に制限されます。
• フィルター値は、上流への呼び出し前にクライアント側で検証されます（日付形式、長さ、ページネーションの範囲）。
• 上流のエラー本文は、そのままではなく SHA-256 のプレフィックスのみが stderr に記録されます。

脆弱性の報告とサポート対象バージョンについては、SECURITY.md を参照してください。

トラブルシューティング

API のプラン

Details Page API

• 無料プラン： get_citation_counts と search_citations を利用できます
• 商用プラン： get_citation_details を含む、Details Page のすべてのツールを利用できます

無料 API キーで get_citation_details を使用しようとすると、403 エラーが返されます。

Explorer API

• 機関向けアクセスのみ： Explorer API のすべてのツールには、機関の認証情報が必要です
• Altmetric データベース全体の研究成果と注目度データにアクセスできます
• データ連携を利用している組織は、自機関の研究成果のみにアクセスすることもできます
• 著者、学部、ジャーナル、組織独自のメタデータによる高度な絞り込みが可能です

ツール

このサーバーは、2 つの API で 12 個のツールを提供します。

すべての Explorer ツールでは、追加で researcher_id と grant_id（Dimensions ID）のフィルター、およびクエリの対象を学術識別子の生のリストに限定する identifiers パラメーターも使用できます。サーバーが対応する識別子リストを作成します。Explorer のレスポンスには、センチメントデータ（研究成果では sentiment-analysis-totals、X／Bluesky での言及では sentiment-analysis）も含まれます。

パラメーターと使用例の詳細については、TOOLS.md を参照してください。

API ドキュメント

• Details Page API： https://docs.altmetric.com/details-page-api/
• Explorer API： https://docs.altmetric.com/explorer-api/

ライセンス

MIT