作者 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.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"nanobot-mcp": {
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。
{
"mcpServers": {
"nanobot-mcp": {
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。
{
"mcpServers": {
"nanobot-mcp": {
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。
{
"mcpServers": {
"nanobot-mcp": {
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}Claude Desktop と同じ形式。Windsurf を再起動して反映。
{
"mcpServers": [
{
"name": "nanobot-mcp",
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
]
}Continue はマップではなくサーバーオブジェクトの配列を使用。
{
"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 で削除。
使うタイミング： You want to understand what FastMCP / Upsonic do under the hood.
結果： Working hackable baseline for your own agent.
Prototype with Nanobot; harden with FastMCP for production
| ツール | 入力 | 呼び出すタイミング | コスト |
|---|---|---|---|
| run | (see docs) | Run a task through the nanobot loop | 1 call |
Planner gets stuckAdd a step budget; minimal planners need explicit halts
| 代替案 | 代わりに使う場面 | トレードオフ |
|---|---|---|
| FastMCP | Production server | More framework |