SourceCraft MCP: два сервера и подключение к Claude, Codex и Cursor

ramgml/sourcecraft-mcp· Проверено 12.11.2026· 0на GitHub

Подключает агента к SourceCraft по личному токену: репозитории, issues, pull requests, релизы и запуски CI/CD. Второй сервер заточен под деплой: запускает workflow, ждёт итога и читает логи кубов.

2 реализации:

Широкий набор: репозитории, ветки, issues, pull requests с ревью, CI/CD и релизы; в пакете есть ещё CLI sourcecraft и скилл для агента.

Как подключить

Что сделать до подключения

uv: сервер и библиотека pysourcecraft подтягиваются из Git при запуске

Личный токен SourceCraft

SOURCECRAFT_API_TOKEN

sourcecraft.dev → Settings → Access → Personal Access Tokens → создать токен с нужными правами

SOURCECRAFT_BASE_URL

необязательно: адрес API, по умолчанию https://api.sourcecraft.tech

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SOURCECRAFT_API_TOKEN=<токен SourceCraft>' --transport stdio sourcecraft \
  -- uv run --with git+https://github.com/ramgml/sourcecraft-mcp.git --with git+https://github.com/ramgml/pysourcecraft.git@v0.1.5 python -m sourcecraft_mcp.server

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.sourcecraft]
command = "uv"
args = ["run", "--with", "git+https://github.com/ramgml/sourcecraft-mcp.git", "--with", "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5", "python", "-m", "sourcecraft_mcp.server"]

[mcp_servers.sourcecraft.env]
SOURCECRAFT_API_TOKEN = "<токен SourceCraft>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "sourcecraft": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/ramgml/sourcecraft-mcp.git",
        "--with",
        "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5",
        "python",
        "-m",
        "sourcecraft_mcp.server"
      ],
      "env": {
        "SOURCECRAFT_API_TOKEN": "<токен SourceCraft>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "sourcecraft": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/ramgml/sourcecraft-mcp.git",
        "--with",
        "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5",
        "python",
        "-m",
        "sourcecraft_mcp.server"
      ],
      "env": {
        "SOURCECRAFT_API_TOKEN": "<токен SourceCraft>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "sourcecraft": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/ramgml/sourcecraft-mcp.git",
        "--with",
        "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5",
        "python",
        "-m",
        "sourcecraft_mcp.server"
      ],
      "env": {
        "SOURCECRAFT_API_TOKEN": "<токен SourceCraft>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "sourcecraft": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/ramgml/sourcecraft-mcp.git",
        "--with",
        "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5",
        "python",
        "-m",
        "sourcecraft_mcp.server"
      ],
      "env": {
        "SOURCECRAFT_API_TOKEN": "<токен SourceCraft>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "sourcecraft": {
        "type": "local",
        "command": [
          "uv",
          "run",
          "--with",
          "git+https://github.com/ramgml/sourcecraft-mcp.git",
          "--with",
          "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5",
          "python",
          "-m",
          "sourcecraft_mcp.server"
        ],
        "environment": {
          "SOURCECRAFT_API_TOKEN": "<токен SourceCraft>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "sourcecraft": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/ramgml/sourcecraft-mcp.git",
        "--with",
        "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5",
        "python",
        "-m",
        "sourcecraft_mcp.server"
      ],
      "env": {
        "SOURCECRAFT_API_TOKEN": "<токен SourceCraft>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "sourcecraft": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/ramgml/sourcecraft-mcp.git",
        "--with",
        "git+https://github.com/ramgml/pysourcecraft.git@v0.1.5",
        "python",
        "-m",
        "sourcecraft_mcp.server"
      ],
      "env": {
        "SOURCECRAFT_API_TOKEN": "<токен SourceCraft>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_organization_repositoriesвыводит репозитории организации

get_file_treeпоказывает дерево файлов

list_branchesвыводит ветки

create_repositoryсоздаёт репозиторий

list_issuesищет issues по фильтрам

create_issueсоздаёт issue

close_issueзакрывает issue

add_issue_commentпишет комментарий к issue

list_pull_requestsвыводит pull requests

create_pull_requestсоздаёт pull request

merge_pull_requestсливает pull request

add_pr_reviewerдобавляет ревьюера

set_review_decisionставит решение ревью

list_ci_runsвыводит запуски CI

get_cube_logsчитает логи куба CI

trigger_workflowsзапускает workflows

create_releaseсоздаёт релиз

list_my_issuesпоказывает мои issues

Сервер на Go под деплой и CI: запуск workflow с подтверждением, долгое ожидание итога, логи и артефакты, поиск по документации CI и вызов любого метода API SourceCraft.

Как подключить

Что сделать до подключения

Go: сервер ставится командой go install github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest или запускается через go run

Личный токен SourceCraft

SOURCECRAFT_PAT

личный токен SourceCraft; сервер берёт его и из файлов ~/.config/sourcecraft/default.env или ./.env.sourcecraft

SOURCECRAFT_ORG / SOURCECRAFT_REPO

необязательно: без них организация и репозиторий берутся из git remote с именем sourcecraft

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SOURCECRAFT_PAT=<токен SourceCraft>' --transport stdio sourcecraft-mcp \
  -- go run github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.sourcecraft-mcp]
command = "go"
args = ["run", "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"]

[mcp_servers.sourcecraft-mcp.env]
SOURCECRAFT_PAT = "<токен SourceCraft>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "sourcecraft-mcp": {
      "command": "go",
      "args": [
        "run",
        "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"
      ],
      "env": {
        "SOURCECRAFT_PAT": "<токен SourceCraft>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "sourcecraft-mcp": {
      "type": "stdio",
      "command": "go",
      "args": [
        "run",
        "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"
      ],
      "env": {
        "SOURCECRAFT_PAT": "<токен SourceCraft>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "sourcecraft-mcp": {
      "command": "go",
      "args": [
        "run",
        "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"
      ],
      "env": {
        "SOURCECRAFT_PAT": "<токен SourceCraft>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "sourcecraft-mcp": {
      "command": "go",
      "args": [
        "run",
        "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"
      ],
      "env": {
        "SOURCECRAFT_PAT": "<токен SourceCraft>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "sourcecraft-mcp": {
        "type": "local",
        "command": [
          "go",
          "run",
          "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"
        ],
        "environment": {
          "SOURCECRAFT_PAT": "<токен SourceCraft>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "sourcecraft-mcp": {
      "command": "go",
      "args": [
        "run",
        "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"
      ],
      "env": {
        "SOURCECRAFT_PAT": "<токен SourceCraft>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "sourcecraft-mcp": {
      "command": "go",
      "args": [
        "run",
        "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"
      ],
      "env": {
        "SOURCECRAFT_PAT": "<токен SourceCraft>"
      }
    }
  }
}

Инструменты сервера

list_runsвыводит запуски

get_runпоказывает статус запуска

run_workflowзапускает workflow

run_deploy_workflowзапускает деплой с подтверждением

wait_runждёт завершения запуска

get_cube_logsчитает логи куба

list_cube_artifactsвыводит артефакты куба

download_artifactскачивает артефакт

search_ci_docsищет по документации CI

list_api_operationsвыводит методы API

call_apiвызывает метод API SourceCraft

envпоказывает текущие настройки

Что попросить агента

«Покажи мне репозитории в организации <организация>»ramgml вызовет list_organization_repositories

«Найди все открытые issues с приоритетом critical в репозитории <организация>/<репозиторий>»ramgml вызовет list_issues с фильтрами status=open и priority=critical

«Создай PR для ветки <ветка> в main в репозитории <организация>/<репозиторий>»ramgml вызовет create_pull_request

«Покажи статус последних CI запусков в <организация>/<репозиторий>»ramgml вызовет list_ci_runs, aacidov — list_runs и get_run

«Запусти деплой deploy-prod для service-b с тегом <тег> и дождись результата»aacidov вызовет run_deploy_workflow со строкой подтверждения и будет ждать итога через wait_run, при ошибке прочитает get_cube_logs

Для каких задач

Найти открытые issues с нужным приоритетом и прокомментировать их

Создать pull request из ветки, назначить ревьюера и слить после ревью

Показать статус последних запусков CI и прочитать логи упавшего куба

Запустить деплой и дождаться, чем он закончится

Выпустить релиз по тегу

Скачать артефакт сборки

Ограничения

Оба сервера сторонние и почти без звёзд: у ramgml 0, у aacidov 1; aacidov последний раз обновлялся в апреле 2026 года

run_deploy_workflow не стартует без строки подтверждения вида deploy <workflow> <target>

call_api не вызывает устаревшие методы API, пока не передан allow_deprecated=true

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
SourceCraft MCP Server	ramgml	0	локально	токен	18	18 сентября 2026
sourcecraft-mcp	aacidov	1	локально	токен	12	20 апреля 2026

Частые вопросы

Какой сервер выбрать?

Для повседневной работы с кодом подойдёт ramgml: issues, pull requests, ревью и релизы. Если агент в основном деплоит и следит за CI, возьмите сервер aacidov: он ждёт долгие запуски, достаёт логи и артефакты и вызывает любой метод API.

Где взять токен SourceCraft?

На sourcecraft.dev откройте Settings → Access → Personal Access Tokens и создайте токен с нужными правами. У ramgml он передаётся в SOURCECRAFT_API_TOKEN, у aacidov — в SOURCECRAFT_PAT.

Как не указывать организацию и репозиторий каждый раз?

Сервер aacidov сам определяет их по git remote с именем sourcecraft. Можно задать SOURCECRAFT_ORG и SOURCECRAFT_REPO в окружении или в файле .env.sourcecraft.

Агент может задеплоить по ошибке?

У aacidov run_deploy_workflow требует отдельную строку подтверждения с именем workflow и целью, например deploy deploy-prod service-b.

Как подключить SourceCraft MCP к Codex?

Для сервера aacidov добавьте в ~/.codex/config.toml блок [mcp_servers.sourcecraft] с command = "go" и args = ["run", "github.com/aacidov/sourcecraft-mcp/cmd/sourcecraft-mcp@latest"]. Токен сервер прочитает из SOURCECRAFT_PAT или файлов настроек SourceCraft.

Работает ли сервер из России?

Серверы работают на вашем компьютере и обращаются к API SourceCraft по вашему личному токену.