@oneforma/mcp-server
v0.2.2
Published
1Forma MCP server — local dev tools for AI assistants + delegate to local CLI coders
Downloads
353
Maintainers
Readme
@oneforma/mcp-server
MCP (Model Context Protocol) server for 1Forma developer tooling. Exposes filesystem, bash, git, build, and 1Forma API operations to AI assistants over stdio or HTTP transport.
Install
npm install -g @oneforma/mcp-serverUsage
stdio mode (default — for IDE integrations)
npx @oneforma/mcp-serverAdd to Claude Code or any MCP-compatible client:
claude mcp add anfisa -- npx @oneforma/mcp-serverHTTP mode (for remote daemons, e.g. Anfisa)
npx @oneforma/mcp-server --http --port 8420Server 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-serverGet 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 |
Run npx @oneforma/mcp-server --list-tools for the full list.
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 versionRequirements
- Node.js ≥ 18
glabCLI (optional, forcreate_mr)- 1Forma PAT (for API tools)
License
MIT
