ace-pm 35dc87ef53 chore: sync workspace state after rebrand

- Rebrand commits already in history (gsd → forge)
- Sync pre-existing doc, docker, and CI config updates
- All rebrand artifacts verified in place:
  * Native crates: forge-engine, forge-ast, forge-grep
  * Log prefixes: [forge] across 22+ files
  * Binary: ~/bin/sf-run
  * Workspace scopes: @sf-run/*, @singularity-forge/*
  * Nix flake: Rust toolchain ready

System ready for: nix develop && bun run build:native

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-15 14:54:20 +02:00

1.7 KiB

Raw Blame History

MCP Servers

SF can connect to external MCP (Model Context Protocol) servers for local tools, internal APIs, self-hosted services, or integrations not built in as native extensions.

Configuration Files

SF reads MCP config from these project-local paths:

.mcp.json — repo-shared config (safe to commit)
.gsd/mcp.json — local-only config (not shared)

If both exist, server names are merged and the first definition found wins.

Supported Transports

Transport	Config Shape	Use When
`stdio`	`command` + optional `args`, `env`, `cwd`	Launching a local MCP server
`http`	`url`	Connecting to an already-running server

Examples

stdio Server

{
  "mcpServers": {
    "my-server": {
      "type": "stdio",
      "command": "/absolute/path/to/python3",
      "args": ["/absolute/path/to/server.py"],
      "env": {
        "API_URL": "http://localhost:8000"
      }
    }
  }
}

HTTP Server

{
  "mcpServers": {
    "my-http-server": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Verifying a Server

After adding config, verify from a SF session:

mcp_servers — confirms SF sees the config
mcp_discover(server="my-server") — confirms the server starts and responds
mcp_call(server="my-server", tool="<tool>", args={...}) — confirms a real tool call works

Tips

Use absolute paths for executables and scripts
Set required environment variables directly in the MCP config's env block
Use .mcp.json for team-shared servers; .gsd/mcp.json for machine-local ones
If a server depends on local paths or personal secrets, keep it in .gsd/mcp.json

1.7 KiB Raw Blame History