linkml-mcp

MCP-Server für die commit-bezogene Bearbeitung von LinkML-YAML-Schemata.

Siehe SCOPE.md für den Projektumfang und die Meilenstein-Grenzen.

Einrichtung

uv sync --dev

Related MCP server: github-mcp-tool

MCP-Server ausführen

Für lokale Tests mit Editor/Codex ist HTTP derzeit der empfohlene Transport:

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

Um Anfragen über einen Hostnamen oder Reverse-Proxy zu akzeptieren, binden Sie an eine Adresse außerhalb von localhost und erlauben Sie den externen Host-Header:

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

Wenn der Proxy einen anderen Host-Header weiterleitet, übergeben Sie diesen Wert mit einem weiteren --allowed-host.

Verwenden Sie diese MCP-Konfiguration:

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

Stdio ist ebenfalls verfügbar:

uv run linkml-mcp

Der Server speichert Arbeitsbereiche standardmäßig unter .linkml-mcp/workspaces. Überschreiben Sie dies mit:

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

Test-Client

Erstellen Sie einen Arbeitsbereich:

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

Wenden Sie einen semantischen Changeset an:

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

Lesen Sie ein Schema bei einem Commit:

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

Führen Sie Tests aus:

uv run pytest