Altmetric MCP服务器
模型上下文协议（MCP）服务器，使AI代理能够访问Altmetric API，以跟踪新闻媒体、政策文件、社交媒体和其他在线平台上研究成果的关注度和范围。
Altmetric监控研究在传统学术引用之外的讨论位置——从主流媒体报道到政策引用、专利引用和社交媒体参与——提供对现实世界研究影响的全面视图。
先决条件
- Node.js>=20.6.0 - （推荐LTS）
- Altmetric API证书 （至少一个）：
- 详细信息页API键 -免费等级或商业访问 - 资源管理器API密钥+机密 -机构准入
还没有钥匙吗？ 请求API访问
快速安装（macOS上的Claude Desktop）
在终端中运行引导安装程序-它检查Node.js，提示您输入API密钥，并自动配置Claude Desktop：
bash
Claude Code
直接从命令行安装：
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
VS Code (GitHub Copilot)
添加到您的项目 `.vscode/mcp.json`:
{ "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" } } } }
重新加载VS代码以应用更改。 [更多信息](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).
Cursor
添加 `~/.cursor/mcp.json`:
{ "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" } } } }
Other MCP clients
任何支持stdio传输的MCP兼容客户端都可以使用此服务器。使用本节顶部的通用配置，使其适应客户端的配置格式。命令总是 `npx` 带args `["-y", "altmetric-mcp"]` 加上API键的环境变量。
## 故障排除
|问题|解决方案|
|---|---|
| `command not found: node` |Node.js尚未安装。 [在此处下载](https://nodejs.org/) （版本20.6.0或更高版本）。 |
|编辑配置后Claude Desktop无法启动| JSON文件有语法错误。检查是否缺少逗号、括号不匹配或尾随逗号。将其粘贴到 [Jsonlin.com](https://jsonlint.com) 以验证。 |
|“MCP服务器启动失败”|运行 `npx -y altmetric-mcp` 在终端中查看实际错误。通常丢失/无效的API密钥或Node.js版本太旧。 |
|工具出现但返回403个错误|您正在使用商业层工具的免费层密钥(`get_citation_details`).使用 `get_citation_counts` 或 `search_citations` 相反。 |
|第一个查询很慢|正常。 `npx` 首次运行时下载该包。后续使用更快。 |
|Explorer工具失败|需要Explorer工具 **两者** `ALTMETRIC_EXPLORER_API_KEY` 和 `ALTMETRIC_EXPLORER_API_SECRET`。确保两者都已设置。 |
## API层
### API详情页
- **免费等级：** 访问 `get_citation_counts` 和 `search_citations`
- **商业层：** 访问所有详细信息页面工具，包括 `get_citation_details`
如果你试图使用 `get_citation_details` 使用免费的API密钥，您将收到一个403错误。
### 资源管理器API
- **仅限机构访问：** 所有Explorer API工具都需要机构证书
- 提供对整个Altmetric数据库中的研究成果和注意力数据的访问
- 具有数据集成的组织也可以单独访问自己的机构研究成果
- 包括按作者、部门、期刊和自定义组织元数据进行高级筛选
## 工具
此服务器跨两个API提供九个工具：
|工具| API |层次|描述|
|---|---|---|---|
| `get_citation_counts` |详细信息页面|免费|按标识符（DOI、PubMed ID等）列出的注意力指标|
| `get_citation_details` |详细信息页面|商业|全文、作者详细信息、元数据|
| `search_citations` |详细信息页面|免费|按时间范围搜索所有输出的注意力数据|
| `explore_research_outputs` |探索者|机构|搜索和过滤研究成果|
| `explore_attention_summary` |探索者|机构|按来源和日期汇总的注意力指标|
| `explore_mentions` |探索者|机构|带有过滤功能的个人提及详情|
| `explore_demographics` |探索者|机构|受众地理和人口统计数据|
| `explore_mention_sources` |探索者|机构|提及来源/渠道分析|
| `explore_journals` |探索者|机构|期刊指标、排名和搜索|
有关详细参数和示例，请参阅 [TOOLS.md](TOOLS.md).
## API 文档
- **API详情页：** https://docs.altmetric.com/details-page-api/
- **资源管理器API：** https://docs.altmetric.com/explorer-api/
## 许可证
麻省理工学院