par 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"
]
}
}
}Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.
{
"mcpServers": {
"nanobot-mcp": {
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.
{
"mcpServers": {
"nanobot-mcp": {
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".
{
"mcpServers": {
"nanobot-mcp": {
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.
{
"mcpServers": [
{
"name": "nanobot-mcp",
"command": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
]
}Continue utilise un tableau d'objets serveur plutôt qu'une map.
{
"context_servers": {
"nanobot-mcp": {
"command": {
"path": "uvx",
"args": [
"nanobot",
"serve",
"--mcp"
]
}
}
}
}Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.
claude mcp add nanobot-mcp -- uvx nanobot serve --mcpUne seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.
Quand l'utiliser : You want to understand what FastMCP / Upsonic do under the hood.
Résultat : Working hackable baseline for your own agent.
Prototype with Nanobot; harden with FastMCP for production
| Outil | Entrées | Quand appeler | Coût |
|---|---|---|---|
| run | (see docs) | Run a task through the nanobot loop | 1 call |
Planner gets stuckAdd a step budget; minimal planners need explicit halts
| Alternative | Quand l'utiliser | Compromis |
|---|---|---|
| FastMCP | Production server | More framework |