algoforge-mcp-server/README.md

2.4 KiB

Algo Forge MCP Server

MCP (Model Context Protocol) server for MQL5 Algo Forge. Lets AI agents manage your MQL5 code repositories directly through 12 tools — create repos, commit .mq5/.mqh files, branch, open pull requests, file issues, tag releases, and explore public projects.

Algo Forge is a Git platform, so the server talks to its standard REST API over HTTPS. There is no terminal, no COM interface, and nothing Windows-specific — it runs anywhere Python runs.

Prerequisites

  • An MQL5 account with access to Algo Forge
  • A personal access token (Algo Forge → Settings → Applications → Generate New Token)
  • Python 3.10+

Setup

cd algoforge-mcp-server
pip install -r requirements.txt

Edit config.json with your token:

{
  "base_url": "https://forge.mql5.io",
  "token": "your_personal_access_token",
  "timeout": 30
}

The token can also be supplied via the FORGE_TOKEN environment variable instead of the config file.

Run

python server.py

This starts the MCP server on stdio transport.

Claude Desktop Configuration

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "algoforge": {
      "command": "python",
      "args": ["C:/path/to/algoforge-mcp-server/server.py"]
    }
  }
}

Claude Code Configuration

claude mcp add algoforge python C:/path/to/algoforge-mcp-server/server.py

Tools

Tool Description
get_me Authenticated user — login, name, profile URL
list_repos List your repositories
create_repo Create a new repository
get_file Read a file's text content
commit_file Create or update a file with a commit
list_branches List branches and their latest commits
create_branch Create a new branch
list_issues List issues (open/closed/all)
create_issue Open a new issue
open_pull_request Open a PR from one branch into another
create_release Tag a version with release notes
search_repos Search public projects (Explore)

Testing

Use the MCP Inspector for interactive testing:

npx @modelcontextprotocol/inspector

Select stdio transport, command: python server.py

Security

The personal access token grants write access to your Algo Forge account. Keep config.json out of version control, and revoke/regenerate the token if it is ever exposed.