linkml-mcp

MCP-сервер для редактирования LinkML YAML-схем с адресацией по коммитам.

См. SCOPE.md — там описаны область проекта и границы этапов.

Настройка

uv sync --dev

Related MCP server: github-mcp-tool

Запуск MCP-сервера

Для локального тестирования с редактором или Codex в настоящее время рекомендуется HTTP-транспорт:

uv run linkml-mcp --transport http --host 127.0.0.1 --port 8765

Чтобы принимать запросы через имя хоста или обратный прокси, привяжите сервер к адресу, отличному от localhost, и разрешите внешний заголовок Host:

uv run linkml-mcp \
  --transport http \
  --host 0.0.0.0 \
  --port 8765 \
  --allowed-host essentialcomplexity.eu

Если прокси передаёт другой заголовок Host, укажите это значение с помощью ещё одного --allowed-host.

Используйте такую конфигурацию MCP:

{
  "servers": {
    "linkml-server": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp"
    }
  },
  "inputs": []
}

Также доступен Stdio:

uv run linkml-mcp

По умолчанию сервер хранит рабочие области в .linkml-mcp/workspaces. Переопределить путь можно так:

export LINKML_MCP_WORKSPACE_ROOT=/path/to/workspaces
export LINKML_MCP_GENERATOR_OUTPUT_ROOT=/path/to/generated

Тестовый клиент

Создайте рабочую область:

uv run linkml-mcp-client init --name test_schema

Примените семантический набор изменений:

uv run linkml-mcp-client apply-change \
  --workspace-id ws_... \
  --base-commit abc123 \
  --changes-json examples/add_person.json \
  --message "Add Person"

Прочитайте схему на коммите:

uv run linkml-mcp-client read-schema \
  --workspace-id ws_... \
  --commit-id def456

Запустите тесты:

uv run pytest