Skip to main content
Glama

sparkit-mcp

SPARKIT 的 MCP 服务器 —— 可从 Claude Desktop、Cursor、Claude Code 或任何其他兼容 MCP 的客户端调用科学研究智能体。

提供了两个工具:

  • research — 提交一个科学问题。SPARKIT 会搜索文献、阅读相关论文,并返回一份带有引用的 Markdown 报告。该工具会阻塞直到任务完成(默认 4 分钟)并直接返回完整报告。

  • get_job_status — 通过 ID 获取之前提交的任务。当 research 在任务完成前返回,或者需要重新查看过往报告时非常有用。

安装

uv tool install sparkit-mcp

或者使用 pip:

pip install sparkit-mcp

以上任一方式都会安装 sparkit-mcp 控制台脚本。(预发布版本:在第一个 PyPI 版本发布之前,请直接从 GitHub 安装: uv tool install "git+https://github.com/SPARKIT-science/sparkit-mcp.git")

Related MCP server: scholar-memory

获取 API 密钥

  1. 在 https://app.sparkit.science/signup 注册(试用版 10 美元可进行 5 次查询;订阅费用每月 50 美元起)。

  2. 访问 https://app.sparkit.science/keys 并创建一个密钥。

  3. 复制该密钥 —— 它仅显示一次。

配置您的 MCP 客户端

Claude Desktop

编辑 claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

添加:

{
  "mcpServers": {
    "sparkit": {
      "command": "sparkit-mcp",
      "env": {
        "SPARKIT_API_KEY": "sk_sparkit_..."
      }
    }
  }
}

重启 Claude Desktop。你应该会在聊天输入框旁边的工具图标中看到 sparkit。

如果 sparkit-mcp 不在 Claude Desktop 的 PATH 中(使用 uv tool 时常见),请使用绝对路径:

"command": "/Users/you/.local/bin/sparkit-mcp"

(在运行 uv tool install 后,使用 which sparkit-mcp 查找路径。)

Cursor

编辑 ~/.cursor/mcp.json(或项目中的 .cursor/mcp.json):

{
  "mcpServers": {
    "sparkit": {
      "command": "sparkit-mcp",
      "env": {
        "SPARKIT_API_KEY": "sk_sparkit_..."
      }
    }
  }
}

重新加载 Cursor(Cmd+Shift+P → “Reload Window”)。

Claude Code

claude mcp add sparkit -e SPARKIT_API_KEY=sk_sparkit_... -- sparkit-mcp

尝试一下

配置完成后,询问 LLM:

使用 SPARKIT 查找关于 WRNIP1 作为癌症合成致死靶点的最新文献。

LLM 将调用 research。预计等待 60-180 秒,然后会收到一份带有内联引用和编号来源列表的 Markdown 报告。

配置

环境变量

默认值

描述

SPARKIT_API_KEY

(必填)

来自 https://app.sparkit.science/keys 的 Bearer 密钥。

SPARKIT_API_BASE

https://jlsteenwyk--sparkit-api-web.modal.run

覆盖 API 基础 URL。适用于暂存环境或自托管部署。

SPARKIT_API_TIMEOUT_SECONDS

30

每个 HTTP 请求的超时时间。不影响 research 的总等待时间;总等待时间由 max_wait_seconds 控制。

工具参考

research(question, response_format?, include_citations?, max_wait_seconds?)

参数

类型

默认值

描述

question

string

—

科学问题。必填。请具体说明。

response_format

"full" 或 "brief"

"full"

返回的 Markdown 报告长度。

include_citations

boolean

true

保持 true 以获取带来源的报告。

max_wait_seconds

int (30-540)

240

在返回 job_id 并提示轮询之前,阻塞等待的时长。

返回 Markdown。如果超时,将返回包含 job_id 的状态行,以便 LLM 稍后调用 get_job_status。

get_job_status(job_id)

如果任务已完成,返回带引用的 Markdown 报告;如果仍在运行,返回状态行;否则返回错误消息。

故障排除

身份验证失败 — SPARKIT_API_KEY 未设置或无效。检查 claude_desktop_config.json 是否有拼写错误;编辑后重启 Claude Desktop。

配额耗尽 — 每月查询次数/试用额度用尽。访问 https://app.sparkit.science/billing。

工具未在 Claude Desktop 中显示 — 检查 Claude Desktop 日志:

  • macOS: ~/Library/Logs/Claude/mcp-server-sparkit.log

  • Windows: %LOCALAPPDATA%\Claude\Logs\mcp-server-sparkit.log

最常见的问题是 command: sparkit-mcp 不在 PATH 中;请替换为 which sparkit-mcp 得到的绝对路径。

任务超时 — max_wait_seconds 上限为 540 秒(9 分钟)。对于非常深入的问题,请提交后轮询 get_job_status,而不是在线等待。SPARKIT 也会自动取消超过其内部限制的任务。

许可证

MIT。

Available Tools

2 tools
get_job_statusA

Fetch the current status (and result if done) of a SPARKIT job.

Use this when research returned before the job finished, or to revisit a previous result by id.

Args: job_id: The id returned by a prior research call.

Returns the cited Markdown report if the job has completed, a status line if it's still running, or a failure message otherwise.

Inputs: job_id (required). Returns: result

researchA

Submit a scientific question to the SPARKIT research agent.

SPARKIT searches the literature, reads relevant papers, and returns a cited Markdown report. Best for questions where a correct answer requires synthesizing across multiple primary sources.

Args: question: Free-text scientific question. Be specific — "Which kinases are upregulated in pancreatic cancer with evidence from human tissue?" works better than "tell me about pancreatic cancer." response_format: "full" (default) for a multi-paragraph Markdown report, or "brief" for a tighter summary. include_citations: Keep True (default) so the report is usable for downstream work; only set False if you specifically want unsourced prose. max_wait_seconds: How long to block waiting for the job before returning the job_id with instructions to poll via get_job_status. Default 240s (4 min). Range 30-540.

Returns the cited Markdown report on success. If the job is still running at the wait limit, returns the job_id and status so the caller can resume with get_job_status.

Inputs: question (required), response_format, include_citations, max_wait_seconds. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: 'research' submits a scientific question and returns either a report or a job ID, while 'get_job_status' retrieves the status or result of a previously submitted job. There is no overlap in functionality.

    Naming Consistency4/5

    Both tool names use snake_case, but 'research' is a single-word noun while 'get_job_status' follows a verb_noun pattern. This minor inconsistency prevents a perfect score.

    Tool Count4/5

    With only two tools, the server covers the essential workflow of submitting a research job and checking its status. While minimal, the count is appropriate for the narrow scope of a scientific research agent.

    Completeness3/5

    The tool set covers the primary use case (submit and retrieve results), but lacks features like job listing, cancellation, or retry. For a simple agent this may suffice, but there are notable gaps in lifecycle management.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables scientific literature research through multi-agent search, analysis, and semantic memory, exposing 9 MCP tools for querying, storing, and retrieving research findings.
      15 PyPI
      2
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search and retrieve academic papers from arXiv and PubMed with citation-grade extraction, providing clean citations and summaries.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to run reproducible, high-recall literature search across seven source families with RRF fusion, fetch open-access full texts (falling back to abstracts), expand citations, export BibTeX/RIS, and audit reference coverage — all without any LLM API key, leaving query planning and writing to the agent. Multiple agent clients share one accumulating literature pool and background search jobs that keep running after sessions close.
      3
      MIT