Metadata-Version: 2.4
Name: research-radar-mcp
Version: 0.2.0
Summary: ScholarRadar MCP Server - paper search, scoring and Chinese digest tools for the iFLYTEK Astron Agent platform
Author: favio9758
License: MIT
Keywords: agent,arxiv,mcp,research,spark
Requires-Python: >=3.10
Requires-Dist: arxiv<5,>=4
Requires-Dist: httpx<1,>=0.28
Requires-Dist: mcp<2,>=1.2
Requires-Dist: openai<3,>=2.45
Requires-Dist: pydantic<3,>=2.7
Description-Content-Type: text/markdown

# research-radar-mcp (ScholarRadar MCP Server)

面向大学生的科研入门与文献追踪 MCP Server，为讯飞星辰（Astron）Agent 平台提供论文检索、相关性评分与中文导读卡片能力。逻辑移植自「科研雷达」后端，去除数据库 / Celery / Redis 依赖，可通过 `uvx` 独立运行。

## 工具（stdio）

| 工具 | 说明 | 依赖 |
| --- | --- | --- |
| `search_papers` | 按关键词检索近期 arXiv 论文 | 无状态（arXiv API） |
| `get_paper_detail` | 获取单篇论文完整摘要与元数据 | 无状态（arXiv API） |
| `score_papers` | 依据学生科研画像对论文批量打分 | 调用星火大模型 |
| `generate_digest` | 生成中文导读卡片（创新点 / 方法要点 / 上手难度评级） | 调用星火大模型 |

## 环境变量

调用星火大模型的工具从环境变量读取凭据（由托管平台注入，不写入代码）：

| 变量 | 说明 | 默认 |
| --- | --- | --- |
| `SPARK_API_KEY` | 星辰 MaaS API Key（`必填`） | — |
| `SPARK_BASE_URL` | OpenAI 兼容端点 | `https://maas-api.cn-huabei-1.xf-yun.com/v2` |
| `SPARK_MODEL` | 模型 ID | `xsparkx2` |

## 运行

```bash
# 直接运行（已发布到 PyPI 后）
uvx research-radar-mcp

# 本地开发
uv sync
uv run research-radar-mcp
```

## 本地调试（MCP Inspector）

```bash
npx -y @cloudbase/mcp-inspector
# Transport = STDIO, Command = uvx, Args = research-radar-mcp
```

## 开发

```bash
uv sync
uv run pytest      # 单元测试（mock arXiv / Spark，无需网络）
uv run ruff check .
```

## License

MIT
