/ Каталог / Песочница / Nanobot
● Сообщество HKUDS ⚡ Сразу

Nanobot

автор HKUDS · HKUDS/nanobot

If FastMCP and Upsonic feel heavy: Nanobot is a few hundred lines of Python that gives you a working personal agent with MCP support.

Nanobot is an academic-style minimal agent framework. Strips most abstraction; you bring tools and an LLM, it gives you the loop. Use it when you want a teachable, hackable baseline for an MCP-aware agent.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

готово

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "nanobot-mcp": {
      "command": "uvx",
      "args": [
        "nanobot",
        "serve",
        "--mcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "nanobot-mcp": {
      "command": "uvx",
      "args": [
        "nanobot",
        "serve",
        "--mcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "nanobot-mcp": {
      "command": "uvx",
      "args": [
        "nanobot",
        "serve",
        "--mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "nanobot-mcp": {
      "command": "uvx",
      "args": [
        "nanobot",
        "serve",
        "--mcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "nanobot-mcp",
      "command": "uvx",
      "args": [
        "nanobot",
        "serve",
        "--mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "nanobot-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "nanobot",
          "serve",
          "--mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add nanobot-mcp -- uvx nanobot serve --mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Nanobot

Learn the agent loop by reading the source

👤 Developers ⏱ ~15 min intermediate

Когда использовать: You want to understand what FastMCP / Upsonic do under the hood.

Поток
  1. Read
    Open the main module — single-file core.✓ Скопировано
    → Mental model
  2. Run
    Start the bot; call its MCP tools from Claude.✓ Скопировано
    → Works
  3. Modify
    Add a tool or change the planner.✓ Скопировано
    → Fork ready

Итог: Working hackable baseline for your own agent.

Комбинации

Сочетайте с другими MCP — эффект x10

nanobot-mcp + fastmcp-prefect

Prototype with Nanobot; harden with FastMCP for production

Combine nanobot-mcp with fastmcp-prefect: Prototype with Nanobot; harden with FastMCP for production✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
run (see docs) Run a task through the nanobot loop 1 call

Стоимость и лимиты

Во что обходится

Квота API
Bound by LLM
Токенов на вызов
Normal
Деньги
Free OSS
Совет
Keep tool sets small — Nanobot is minimal, not magical

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: LLM keys in env
Исходящий трафик: Configured provider

Устранение неполадок

Частые ошибки и исправления

Planner gets stuck

Add a step budget; minimal planners need explicit halts

Альтернативы

Nanobot в сравнении

АльтернативаКогда использоватьКомпромисс
FastMCPProduction serverMore framework

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills