@oneforma/mcp-server

MCP (Model Context Protocol) server for 1Forma developer tooling. Exposes filesystem, bash, git, build, 1Forma API, and delegate-coding (spawn local CLI coders like claude-code, qwen-cc, kimi, gemini, glm-cc, mm-cc, cursor-cc and stream their progress to a backend) to AI assistants over stdio or HTTP transport.

Install

npm install -g @oneforma/mcp-server

Usage

stdio mode (default — for IDE integrations)

npx @oneforma/mcp-server

Add to Claude Code or any MCP-compatible client:

claude mcp add anfisa -- npx @oneforma/mcp-server

HTTP mode (for remote daemons, e.g. Anfisa)

npx @oneforma/mcp-server --http --port 8420

Server listens on http://127.0.0.1:8420/mcp. Stateful sessions via mcp-session-id header.

Authentication

For tools that interact with the 1Forma API (get_task, create_comment, download_file, upload_file, list_comments):

npx @oneforma/mcp-server --login --pat <your-1forma-PAT>
# saves to OS keychain (macOS Keychain / Windows Credential Manager / encrypted file on Linux)

Or via environment variables:

ONEFORMA_PAT=<pat> ONEFORMA_SERVER=ru.1forma.ru npx @oneforma/mcp-server

Get a PAT at: https://ru.1forma.ru/user/tokens

Tools

| Tool | Description | |------|-------------| | read_file, write_file, list_directory | Filesystem operations | | bash | Execute shell commands in cwd | | git_status, git_diff, git_log | Read-only git | | git_commit, git_branch | Write git operations | | build | Run project build (auto-detects package manager) | | get_task, list_comments, create_comment | 1Forma task API | | download_file, upload_file | 1Forma file API | | create_mr | GitLab merge request via glab CLI | | delegate_code | Spawn local CLI coder (claude-code/qwen-cc/kimi/gemini/glm-cc/mm-cc/cursor-cc) and stream progress events to backend | | delegate_status | Get local status of a delegate session | | delegate_cancel | Cancel a running delegate session (idempotent, SIGTERM→5s→SIGKILL) | | get_environment | Discover available delegate agents, deployment mode (mac/container), workspace state, active jobs | | register_agent | Register BYO credentials for kimi/glm-cc/cursor-cc/gemini/mm-cc (OAuth flow or paste token) |

Run npx @oneforma/mcp-server --list-tools for the full list (28 tools).

Delegate-coding

The delegate_* tools spawn a local CLI coder as a subprocess and stream its progress (tool calls, edits, terminal events) to a backend via authenticated HTTP. Designed for the 1Forma Anfisa AI agent to delegate code-heavy tasks. Backend contract: 1F-Delegate-Token per session (40-char base64url, never persisted to disk), event schema with type/phase/summary/details, mandatory heartbeat every 60s.

Supported agents: claude-code (Anthropic corp), qwen-cc (local oMLX), kimi (BYO), gemini (corp/BYO), glm-cc / mm-cc / cursor-cc (BYO via Anthropic-compat wrappers).

Per-CLI event adapters parse stdout into a unified schema:

• claude-code adapter: native stream-json (also used for qwen-cc/glm-cc/mm-cc/cursor-cc wrappers)
• kimi adapter: textual regex
• gemini adapter: textual regex with \r quirks

Full daemon-side spec: see spec-mcp-server-delegate.md (internal).

Options

--cwd <path>         Working directory (default: current)
--server <host>      1Forma server hostname (default: ru.1forma.ru)
--http               HTTP transport mode
--port <n>           HTTP port (default: 8420)
--login              Save PAT to keychain
--logout             Remove stored credentials
--list-tools         List tools and exit
--help               Show help
--version            Show version

Requirements

• Node.js ≥ 18
• glab CLI (optional, for create_mr)
• 1Forma PAT (for API tools)

License

MIT