mcp
Working with MCP (Model Context Protocol) servers in Freebuff Desktop: discovering tools via native search_mcp_tools / call_mcp_tool, bridging stdio servers via _scripts/mcp-call.py, injecting .env se
SKILL.mdskills/mcp/SKILL.md
GitHubmcp — MCP tooling router
Home branch in Memora:
root/skill/mcp.Tool priority in Freebuff Desktop: (1) native
search_mcp_tools+call_mcp_tool, (2)python _scripts/mcp-call.py <server> <tool> '<json>'when a stdio server is not yet mounted in the live session.
Choosing a part
| Situation | Part |
|---|---|
| Discover and call MCP tools in the current session | parts/mcp-usage/ |
| Batch install/repair servers, fix native bindings and env | parts/mcp-batch-install-and-repair/ |
Configure .env secrets via the root .env exporter |
parts/mcp-auth-handler/ |
| Diagnose tool-call failures, connection closed, moved paths | parts/mcp-repair/ |
| Build a new MCP server from scratch or from an OpenAPI spec | parts/mcp-builder/ |
Rules
- Walk
root/skill/mcpin Memora before changing server configs; record probe results as nodes. - Use
ask_questionsbefore enabling/disabling servers in~/.agents/mcp.jsonor adding new third-party dependencies. - Never inline plaintext tokens in
~/.agents/mcp.json— place secrets in the root.envand wrap the server command with the root.envexporter. - Pin package versions in
~/.agents/mcp.json(no blind@latest). On-demand servers live in_scripts/mcp-catalog-disabled.json. - If
read_filesreturns[BLOCKED]on an ordinary non-secret file covered by.gitignore(such asinbox/or_archive/), read it via the terminal (python/sed); never bypass secret rules for.env.
Related
memory (memora MCP), research (searchmcp and parallel MCPs), browser (browsermcp and playwright MCPs).