mirror of
https://github.com/semantica-agi/semantica.git
synced 2026-09-10 04:00:35 +00:00
6ad2e8b615
* docs(mcp): update stale MCP tool count from 12 to 15 TOOLS in semantica/mcp_server/__init__.py ships 15 tools, but the README table stopped at get_graph_summary and docs/guides/mcp-server.md still said 12 in its opening line and setup steps while saying 15 elsewhere on the same page. Add the three missing rows (query_graph, update_node, delete_node) to the README table and align the guide's counts. Also fix the same stale count in the openclaw integration docstring. Fixes #1487 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> * docs(openclaw): fix stale MCP tool count 12 → 15 and add missing tool rows --------- Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com> Co-authored-by: Sameer Kadam <sskadam6305@gmail.com> Co-authored-by: Sameer Kadam <sameerkadam@Mac.lan>
58 lines
1.9 KiB
Python
58 lines
1.9 KiB
Python
"""
|
||
Semantica × OpenClaw Integration
|
||
==================================
|
||
|
||
First-class integration between the Semantica semantic intelligence stack and
|
||
`OpenClaw <https://openclaw.ai>`_ — the open-source personal AI agent platform.
|
||
|
||
OpenClaw connects to external tools via MCP (Model Context Protocol). This
|
||
integration exposes the full Semantica MCP surface (15 tools, 3 resources) to
|
||
any OpenClaw agent and also ships a lightweight ``OpenClawKGTool`` that can be
|
||
dropped directly into an OpenClaw SOUL.md tool-list as a native tool.
|
||
|
||
Public surface
|
||
--------------
|
||
OpenClawKGTool — Thin wrapper around the Semantica REST API usable as an
|
||
OpenClaw native tool (no MCP gateway required)
|
||
OpenClawMCPConfig — Helper that emits the ``mcporter.json`` snippet needed to
|
||
wire Semantica's MCP server into an OpenClaw gateway
|
||
|
||
Quick start
|
||
-----------
|
||
pip install semantica
|
||
|
||
>>> from integrations.openclaw import OpenClawKGTool, OpenClawMCPConfig
|
||
>>> print(OpenClawMCPConfig().to_json()) # paste into mcporter.json
|
||
>>> tool = OpenClawKGTool(base_url="http://localhost:8000")
|
||
>>> result = tool.extract("OpenClaw is an open-source AI agent framework.")
|
||
|
||
MCP quick start
|
||
---------------
|
||
Run the Semantica MCP server once::
|
||
|
||
python -m semantica.mcp_server
|
||
|
||
Then add the printed config snippet to your OpenClaw ``mcporter.json`` and
|
||
restart the OpenClaw Gateway::
|
||
|
||
openclaw gateway restart
|
||
|
||
All 15 Semantica tools are then available as native OpenClaw agent tools.
|
||
|
||
Compatibility
|
||
-------------
|
||
Requires ``semantica >= 0.3.0``. The MCP path requires ``python >= 3.8`` and
|
||
a running ``semantica.mcp_server`` instance. The REST path requires a running
|
||
``semantica.server`` instance (``python -m semantica.server``, port 8000 by
|
||
default).
|
||
"""
|
||
|
||
from .mcp_tool import OpenClawKGTool, OpenClawMCPConfig
|
||
|
||
__all__ = [
|
||
"OpenClawKGTool",
|
||
"OpenClawMCPConfig",
|
||
]
|
||
|
||
__version__ = "0.1.0"
|