convez.ai
MCP ServerIntegração & APIsAvançado
hope4b

Onto MCP Server

hope4b/mcp

Integração MCP com plataforma Onto para gestão de dados e memória de agentes

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server para integração com a plataforma Onto, oferecendo acesso a ferramentas para gerenciar realms, templates, entidades, memória de agentes e artefatos. Implementado em FastMCP com suporte a autenticação via API key e múltiplos transportes (stdio/HTTP).

Instalação

$npx convez-ai hope4b/mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
3
Acompanhando
0
Saúde
28%
Último commit
há 6 dias
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Integrar assistentes IA com arquivos de memória estruturados da plataforma Onto
  • Criar e gerenciar templates e entidades em realms específicos
  • Buscar e manipular artefatos de memória de agentes com controle de ciclo de vida
  • Implementar fluxos de revisão e aprovação de artefatos em sistemas multi-agente

Veredito

Server robusto e bem estruturado para quem precisa integrar Claude com a plataforma Onto. Requer configuração adequada de credenciais e conhecimento da arquitetura de realms/templates, adequado para arquiteturas enterprise com fluxos de memória complexos.

README

A tradução para o português deste README ainda está na fila.

Onto MCP Server

FastMCP server for Onto platform access via a configured Onto API key.

Runtime Contract

Required environment variables:

  • ONTO_API_BASE
  • ONTO_API_KEY

Optional environment variables:

  • ONTO_API_KEY_HEADER default: X-API-Key
  • ONTO_API_KEY_PASSTHROUGH_HEADER default: X-Onto-Api-Key
  • MCP_TRANSPORT values: stdio, http
  • PORT
  • SESSION_STATE_API_BASE
  • SESSION_STATE_API_KEY

The server no longer supports login/password, OAuth code exchange, or manual user token flows.

In HTTP mode, Onto backend authentication can come from either:

  • server-side ONTO_API_KEY
  • incoming request header X-Onto-Api-Key (or the value of ONTO_API_KEY_PASSTHROUGH_HEADER)

SESSION_STATE_API_KEY remains optional unless you use the session-state helper tools.

Tools

  • how_to_use_onto_mcp(question="", safety_mode="read_only")
  • list_available_realms()
  • about_onto(focus="")
  • search_templates(name_part, realm_id=None, include_children=False, include_parents=False)
  • search_relation_templates(realm_id, relation_type_name="", meta_ids=None)
  • search_entities_by_relations(realm_id, searched_meta_ids, predicates=None, include_descendants=True, first=0, offset=100, sort=None)
  • search_agent_memory(realm_id, target_kind, target_id, memory_kind="", status="", reality="", author_id="", source_ref="", branch_id="", query="", first=0, offset=100)
  • get_agent_memory_record(realm_id, record_id)
  • create_memory_artifact_draft(realm_id, artifact_path, artifact_kind, write_mode, body, summary, source_ref, source_context=None, review_destination=None, agent_principal="", targets=None)
  • get_memory_artifact(realm_id, artifact_id)
  • get_memory_artifact_by_path(realm_id, artifact_path)
  • get_own_memory_artifact_draft_by_path(realm_id, artifact_path, agent_principal)
  • search_memory_artifacts(realm_id, artifact_kind="", write_mode="", artifact_path="", review_destination="", target_kind="", target_id="", query="", first=0, offset=100)
  • update_memory_artifact_draft(realm_id, artifact_id, body=None, summary=None, review_destination=None, agent_principal="", targets=None)
  • append_memory_artifact(realm_id, artifact_id, body, source_ref, summary="", source_context=None, agent_principal="")
  • submit_memory_artifact(realm_id, artifact_id)
  • accept_memory_artifact(realm_id, artifact_id)
  • revoke_memory_artifact(realm_id, artifact_id)
  • supersede_memory_artifact(realm_id, artifact_id, artifact_path, artifact_kind, write_mode, body, summary, source_ref, source_context=None, review_destination=None, agent_principal="", targets=None)
  • search_objects(realm_id=None, name_filter="", template_uuid="", comment_filter="", load_all=False, page_size=20)
  • create_realm(name, comment="")
  • update_realm(realm_id, name, comment="")
  • delete_realm(realm_id)
  • save_template(realm_id, name, comment="", template_id="")
  • create_template(realm_id, name, comment="")
  • get_template(realm_id, template_id, include_children=False, include_parents=False, name="")
  • delete_template(realm_id, template_id)
  • link_template_to_parents(realm_id, child_template_id, parent_template_ids)
  • unlink_template_from_parents(realm_id, child_template_id, parent_template_ids)
  • save_entity(realm_id, name, comment="", entity_id="", meta_entity_id="")
  • save_entities_batch(realm_id, entities)
  • create_entities_batch(realm_id, entities)
  • get_entity(realm_id, entity_id, related_diagrams=False, related_entities=False, with_empty_stickers=False, name="")
  • get_node_chat_messages(realm_id, node_id)
  • create_node_chat_message(realm_id, node_id, text)
  • search_entities(realm_id=None, name_filter="", meta_entity_id="", comment_filter="", include_inherited=False, offset=0, limit=20)
  • search_entities_with_related_meta(realm_id=None, name_filter="", meta_entity_id="", comment_filter="", include_inherited=False, offset=0, limit=20)
  • delete_entity(realm_id, entity_ids, name="")
  • save_entity_fields(realm_id, entity_id, fields)
  • delete_entity_fields(realm_id, entity_id, field_ids)
  • save_template_fields(realm_id, template_id, fields)
  • delete_template_fields(realm_id, template_id, field_ids)
  • search_diagrams(realm_id, name_part="", tag_ids=None, page=1, size=20)
  • search_context_tags(realm_id, name_part="", page=1, size=20)
  • create_context_tag_from_object(realm_id, entity_id)
  • add_diagram_tag(realm_id, diagram_id, tag_id)
  • remove_diagram_tag(realm_id, diagram_id, tag_id)
  • add_existing_nodes_to_diagram(realm_id, diagram_id, nodes)
  • create_diagram(realm_id, name, comment="")
  • get_diagram(realm_id, diagram_id)
  • update_diagram(realm_id, diagram_id, name="", comment="", tag_ids=None)
  • delete_diagram(realm_id, diagram_id)
  • create_relation(realm_id, start_entity_id, end_entity_id, relation_type_name, start_role="", end_role="", additional_properties=None)
  • update_relation(realm_id, start_entity_id, end_entity_id, relation_type_name, start_role="", end_role="", additional_properties=None)
  • delete_relation(realm_id, start_entity_id, end_entity_id, relation_type_name, name="")
  • create_meta_relation(realm_id, start_meta_id, end_meta_id, relation_type_name, start_min=0, start_max=1, end_min=0, end_max=1, equal=False)
  • update_meta_relation(realm_id, start_meta_id, end_meta_id, relation_type_name, start_min=0, start_max=1, end_min=0, end_max=1, equal=False)
  • delete_meta_relation(realm_id, start_meta_id, end_meta_id, relation_type_name)
  • saveOntoAIThreadID(thread_external_id, ctx)
  • getOntoAIThreadID(ctx)

Agent operational guidance is defined by the canonical machine-readable contract in onto_mcp/agent_contract.json, exposed at runtime through how_to_use_onto_mcp, and summarized for humans in docs/AGENT_ENTRY_GUIDE.md.

Resources

  • onto://spaces
  • onto://user/info

Configuration Example

{
  "mcpServers": {
    "onto-mcp-server": {
      "command": "python",
      "args": ["-m", "onto_mcp.server"],
      "cwd": "/path/to/repo",
      "env": {
        "ONTO_API_BASE": "https://app.ontonet.ru/api/v2/core",
        "ONTO_API_KEY": "replace-with-onto-api-key"
      }
    }
  }
}

Running

python -m pip install -r requirements.txt
python -m onto_mcp.server

HTTP mode:

MCP_TRANSPORT=http PORT=8080 python -m onto_mcp.server

If you use HTTP mode or session-state helpers, also configure SESSION_STATE_API_KEY.

Ver o original no GitHub

Bom para

Relacionados