Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Sakana

БесплатноНе проверен

MCP server that wraps Sakana AI Scientist v2 so MCP Client (claude, cursor...) can act as a research director for autonomous scientific loops.

GitHubEmbed

Описание

MCP server that wraps Sakana AI Scientist v2 so MCP Client (claude, cursor...) can act as a research director for autonomous scientific loops.

README

FastMCP Version Ruff Built with Just

sakana-mcp

MCP server that wraps Sakana AI Scientist v2 so Cursor can act as a research director for autonomous scientific loops.

Documentation Map

  • README.md (this file): entrypoint and quick start
  • docs/README.md: full docs index
  • docs/architecture/README.md: system architecture and component boundaries
  • docs/researcher/README.md: researcher-facing workflow (ideate -> execute -> status -> review)
  • docs/operations/README.md: Docker, safety model, runbooks, and troubleshooting
  • research_library/README.md: sample research task catalog
  • prompts/README.md: reusable prompt templates
  • skills/FASTMCP_3_1_SKILL.md: FastMCP 3.1.0 operator skill card
  • docs/ONBOARDING.md: first-time setup (keys, Docker, vendor checkout) — read this before just serve

New here? Start with docs/ONBOARDING.md (15 min: keys → Docker → vendor → Go Live Checklist).

Core Guarantees

  • Tool-based orchestration: MCP tools map to ideation, execution, review, and status loops
  • Sandbox-first execution: experiment code runs in Docker to reduce host contamination risk
  • Deep-memory export: run artifacts are persisted in research_vault for downstream RAG indexing

Tool Surface

  • research_ideate: generate 5 hypotheses using AI-Scientist v2 ideation if available
  • research_execute: run experiment manager in Docker with num_workers and max_debug_depth
  • research_status: summarize buggy/non-buggy tree nodes from run artifacts
  • research_review: run VLM figure/caption/reference review on a produced PDF
  • research_library: browse built-in + custom sample research missions
  • research_workflow_plan: generate guided agentic step plan for a selected task

Stack

  • Backend: Python 3.12+, FastMCP 3.4.5 (stdio), FastAPI + uvicorn (dashboard :10863), pydantic v2, httpx, ruff + mypy gates, pytest smoke suite
  • Frontend: React 18 + Vite 5 + TailwindCSS 3 + TanStack Query + React Router (dashboard :10862), TypeScript strict, Biome 2.4 gate, Playwright e2e
  • Runtime: Docker Compose (sakana-mcp + GPU scientist-executor), Tauri shell (native/), MCPB bundle via fleet shim (just mcpb-pack)

Research Warehousing

All major events are appended to warehouse manifests under:

  • research_vault/warehouse/manifests/*.jsonl

Warehouse directories are auto-created under research_vault/warehouse:

  • runs, reviews, manuscripts, datasets, manifests, exports

Environment Variables

  • GEMINI_API_KEY: required for Gemini-backed ideation/review paths
  • S2_API_KEY: Semantic Scholar key for literature-heavy workflows
  • RESEARCH_VAULT_PATH: optional; defaults to ./research_vault
  • AI_SCIENTIST_V2_PATH: optional; defaults to ./vendor/ai-scientist-v2

Quick Start

git clone https://github.com/sandraschi/sakana-mcp
cd sakana-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

  1. Clone this repo and ensure vendor/ai-scientist-v2 exists.
  2. Set required environment variables.
  3. Build Docker images:
  • docker compose build
  1. Run MCP server locally:
  • python -m sakana_mcp.server

Safety Position

Docker is strongly recommended and treated as the default execution path for experiments because AI-Scientist v2 executes model-generated code.

🛡️ Industrial Quality Stack

This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:

  • Python (Core): Ruff for linting and formatting. Zero-tolerance for print statements in core handlers (T201).
  • Webapp (UI): Biome for sub-millisecond linting. Strict noConsoleLog enforcement.
  • Protocol Compliance: Hardened stdout/stderr isolation to ensure crash-resistant JSON-RPC communication.
  • Automation: Justfile recipes for all fleet operations (just lint, just fix, just dev).
  • Security: Automated audits via bandit and safety.

from github.com/sandraschi/sakana-mcp

Установка Sakana

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/sandraschi/sakana-mcp

FAQ

Sakana MCP бесплатный?

Да, Sakana MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Sakana?

Нет, Sakana работает без API-ключей и переменных окружения.

Sakana — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Sakana в Claude Desktop, Claude Code или Cursor?

Открой Sakana на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Opencode Omniroute Plugin

OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc

GitHub Actionsавтор: GitHub Actions
80

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Antigravity Drawio

MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.

S-SUJAN-Sавтор: S-SUJAN-S

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

Compare Sakana with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai