sparkit-mcp

SPARKIT 用のMCPサーバーです。Claude Desktop、Cursor、Claude Code、またはその他のMCP互換クライアントから科学研究エージェントを呼び出すことができます。

以下の2つのツールが公開されています：

• 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" でインストールしてください。）

APIキーの取得

1. https://app.sparkit.science/signup でサインアップします（Try-itは5クエリで10ドル、サブスクリプションは月額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に次のように尋ねてみてください：

Use SPARKIT to look up the most recent literature on the role of WRNIP1 as a synthetic-lethal target in cancer.

LLMが research を呼び出します。60〜180秒ほど待つと、インライン引用と番号付きのソースリストを含むMarkdownレポートが返されます。

設定

ツールリファレンス

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

Markdownを返します。タイムアウトした場合は、LLMが後で get_job_status を呼び出せるようにジョブIDを含むステータス行を返します。

get_job_status(job_id)

ジョブが完了していれば引用付きのMarkdownレポートを、まだ実行中であればステータス行を、それ以外の場合はエラーメッセージを返します。

トラブルシューティング

Authentication failed — SPARKIT_API_KEY が設定されていないか、無効です。claude_desktop_config.json に誤字がないか確認し、編集後にClaude Desktopを再起動してください。

Quota exhausted — 月間クエリ数またはTry-itクレジットが上限に達しています。https://app.sparkit.science/billing を確認してください。

Tool isn't appearing in 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 で確認した絶対パスに置き換えてください。

Job times out — max_wait_seconds の上限は540秒（9分）です。非常に深い質問の場合は、インラインで待機するのではなく、送信後に get_job_status をポーリングしてください。SPARKITは、内部制限を超えたジョブを自動的にキャンセルします。

ライセンス

MIT。