Sakana
БесплатноНе проверенMCP server that wraps Sakana AI Scientist v2 so MCP Client (claude, cursor...) can act as a research director for autonomous scientific loops.
Описание
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 startdocs/README.md: full docs indexdocs/architecture/README.md: system architecture and component boundariesdocs/researcher/README.md: researcher-facing workflow (ideate -> execute -> status -> review)docs/operations/README.md: Docker, safety model, runbooks, and troubleshootingresearch_library/README.md: sample research task catalogprompts/README.md: reusable prompt templatesskills/FASTMCP_3_1_SKILL.md: FastMCP 3.1.0 operator skill carddocs/ONBOARDING.md: first-time setup (keys, Docker, vendor checkout) — read this beforejust 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_vaultfor downstream RAG indexing
Tool Surface
research_ideate: generate 5 hypotheses using AI-Scientist v2 ideation if availableresearch_execute: run experiment manager in Docker withnum_workersandmax_debug_depthresearch_status: summarize buggy/non-buggy tree nodes from run artifactsresearch_review: run VLM figure/caption/reference review on a produced PDFresearch_library: browse built-in + custom sample research missionsresearch_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+ GPUscientist-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 pathsS2_API_KEY: Semantic Scholar key for literature-heavy workflowsRESEARCH_VAULT_PATH: optional; defaults to./research_vaultAI_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:
- Clone this repo and ensure
vendor/ai-scientist-v2exists. - Set required environment variables.
- Build Docker images:
docker compose build
- 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
printstatements in core handlers (T201). - Webapp (UI): Biome for sub-millisecond linting. Strict
noConsoleLogenforcement. - Protocol Compliance: Hardened
stdout/stderrisolation to ensure crash-resistant JSON-RPC communication. - Automation: Justfile recipes for all fleet operations (
just lint,just fix,just dev). - Security: Automated audits via
banditandsafety.
Установка Sakana
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/sandraschi/sakana-mcpFAQ
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 ActionsRoblox Studio
Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce
автор: paralovAntigravity Drawio
MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.
автор: S-SUJAN-SFetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
автор: modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
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-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
автор: lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
Compare Sakana with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории ai
