linkml-mcp

Servidor MCP para edición de esquemas YAML de LinkML direccionada por commit.

Consulta SCOPE.md para el alcance del proyecto y los límites de los hitos.

Configuración

uv sync --dev

Related MCP server: github-mcp-tool

Ejecutar el servidor MCP

Para pruebas con editor local/Codex, HTTP es actualmente el transporte recomendado:

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

Para aceptar solicitudes a través de un nombre de host o proxy inverso, vincula más allá de localhost y permite la cabecera Host externa:

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

Si el proxy reenvía una cabecera Host diferente, pasa ese valor con otro --allowed-host.

Usa esta configuración de MCP:

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

Stdio también está disponible:

uv run linkml-mcp

El servidor almacena los espacios de trabajo en .linkml-mcp/workspaces de forma predeterminada. Sobrescribe esto con:

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

Cliente de prueba

Crea un espacio de trabajo:

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

Aplica un changeset semántico:

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

Lee un esquema en un commit:

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

Ejecuta las pruebas:

uv run pytest