MCP工具框架

git clone https://github.com/GuyMannDude/frankenclaw.git
pip install -r requirements.txt

Or skip the manual step and let [`./robot-install.sh`](#non-interactive-install-for-llm-agents-and-ci)
emit a ready-to-paste `mcp_snippet` block — it points at the venv's
Python so the host doesn't accidentally launch FrankenClaw against
system Python.

### Where the config file lives, per host

| Host | Path / command | Notes |
|---|---|---|
| **Claude Desktop** | `claude_desktop_config.json` (location varies by OS — see Anthropic docs) | Restart Claude Desktop after editing. |
| **Claude Code** | `claude mcp add frankenclaw -- python3 /path/to/frankenclaw/server.py` | One command; no JSON editing. |
| **LM Studio** | `~/.lmstudio/mcp.json` (Linux/macOS) · `%USERPROFILE%\.lmstudio\mcp.json` (Windows) | Native MCP since v0.3.17. Restart LM Studio. |
| **AnythingLLM** | `anythingllm_mcp_servers.json` (path varies by OS) | Flip workspace to **Automatic** mode (Settings → Chat Settings) so tools fire without `@agent` prefix. |
| **Open WebUI** | Settings → Tools → MCP Servers → add stdio server | GUI, no file editing. |
| **Jan** | Settings → Extensions → MCP Servers | GUI; uses the same JSON shape. |
| **LobeChat** | Settings → Plugins → MCP → Add custom MCP server | Type `stdio`, command `python3 /ABSOLUTE/PATH/TO/frankenclaw/server.py`. |
| **Hermes Agent** | `hermes mcp add frankenclaw -- python3 /path/to/server.py` | First-class MCP support since v0.12.0. |
| **Agent Zero** | In-container MCP config | Use *container-side* paths, not host paths. |
| **OpenClaw** | `openclaw mcp set frankenclaw '{"command":"python3","args":["/path/to/server.py"]}'` then `openclaw gateway restart` | Same MCP shape; gateway restart picks up the new tool registration. |
| **Ollama** (no native MCP) | `~/.mcphost.yaml` with `type: local`, command + args under `mcpServers.frankenclaw` | Ollama Desktop's own chat window doesn't support MCP — use [MCPHost](https://github.com/mark3labs/mcphost) or [ollmcp](https://github.com/jonigl/mcp-client-for-ollama) as the bridge. Pair with a tool-capable model: `model: "ollama:qwen3:8b"`. |
| **llama.cpp** | `llama-server -m model.gguf --mcp-config /path/to/mcp.json` | Reuse the LM Studio shape for `mcp.json`. |

### Things to get right for every host

- **Absolute paths only.** Relative paths break silently — the host spawns FrankenClaw from the wrong cwd and Python throws ENOENT.
- **Use a tool-capable model.** Qwen3, Llama 3.2, Mistral, and Gemma 2 invoke tools correctly. Small models often *narrate* tool calls instead of making them — `qwen3:8b` verified working on AnythingLLM, `llama3.1:8b` known to fake calls.
- **Coexists cleanly with [Mnemo Cortex](https://github.com/GuyMannDude/mnemo-cortex).** Just add a second `mcpServers` entry. They don't conflict — your agent gets memory + hands in the same session.

> **Heads-up for Windows users:** if a tool you add ships native Linux/macOS binaries (browser automation engines are the usual culprit), install and run FrankenClaw inside **WSL2**. The chassis core and pure-Python tools like the bundled `web_scrape` work native-Windows; WSL2 is the safe default when a tool has system dependencies.

For host pass/fail and the rest of our field findings: **[projectsparks.ai/field-guide](https://projectsparks.ai/field-guide)**.

改完保存。Windows 用户注意：如果 `command` 写 `npx` 起不来，换成 `npx.cmd` 再试。

### 第 3 步：重启并验证

完全退出客户端再打开（是托盘里真正退出，不是关窗口）。工具列表里出现MCP工具框架的工具即接入成功；调用报错的话，先查下面的坑点清单。