ogm-agent-bridge
MCP stdio bridge from Claude Code, OpenCode, and Hermes to one OpenGraphMemory project.
Bridge uses authenticated OpenGraphMemory REST APIs only. It is stateless: no local database, session mapping, direct PostgreSQL, Neo4j, or object-store access.
Status
Alpha. PyPI releases are published from GitHub Actions on v* tags. Source install is also supported for development.
Tools
ogm_healthogm_list_datasetsogm_search_entitiesogm_get_entityogm_get_neighborsogm_find_pathogm_get_subgraphogm_get_graphogm_get_evidenceogm_get_relation_evidenceogm_upload_documentogm_memory_list_episodesogm_memory_get_episodeogm_memory_searchogm_memory_create_episodeogm_memory_append_attemptogm_memory_record_outcomeogm_memory_feedback_episodeogm_memory_supersede_episodeogm_memory_feedback_patternogm_memory_supersede_pattern
Read tools inspect PostgreSQL-authoritative graph and Agent Memory data. Agent Memory results are historical claims: inspect recorded evidence and verifiers before relying on them. personal-safe permits reviewed document upload and additive Agent Memory records; memory-curator additionally permits memory feedback and supersession. No delete, admin, project-create, relation-review, analytics-refresh, semantic-retrieval, or automatic conversation-ingestion tools exist.
Install
Install from PyPI with uv:
uv tool install ogm-agent-bridge
Or run without installing:
uvx ogm-agent-bridge==0.1.7 --version
pipx also works:
pipx install ogm-agent-bridge
For source development:
git clone https://github.com/ardiannurcahya/ogm-agent-bridge.git "$HOME/src/ogm-agent-bridge"
cd "$HOME/src/ogm-agent-bridge"
uv sync --locked
Configure
Set these environment variables before starting your MCP client:
OGM_BASE_URL=http://localhost:8000
OGM_API_KEY=<project-api-key>
OGM_PROJECT_ID=<project-uuid>
OGM_PERMISSION_PROFILE=read-only
Use OGM_PERMISSION_PROFILE=read-only for graph and Agent Memory retrieval. Use OGM_PERMISSION_PROFILE=personal-safe for reviewed uploads and additive Agent Memory records. Use memory-curator only for reviewed feedback and supersession.
Optional upload roots:
OGM_UPLOAD_ROOTS=/absolute/path/to/allowed/docs
More options: Configuration.
MCP Client Setup
Claude Code
Add MCP server config to project .mcp.json:
{
"mcpServers": {
"ogm": {
"command": "uvx",
"args": ["ogm-agent-bridge==0.1.7"],
"env": {
"OGM_BASE_URL": "${OGM_BASE_URL}",
"OGM_API_KEY": "${OGM_API_KEY}",
"OGM_PROJECT_ID": "${OGM_PROJECT_ID}",
"OGM_PERMISSION_PROFILE": "${OGM_PERMISSION_PROFILE}"
}
}
}
}
Verify:
claude mcp list
OpenCode
Add MCP server config to opencode.json or opencode.jsonc:
{
"mcp": {
"ogm": {
"type": "local",
"command": ["uvx", "ogm-agent-bridge==0.1.7"],
"environment": {
"OGM_BASE_URL": "{env:OGM_BASE_URL}",
"OGM_API_KEY": "{env:OGM_API_KEY}",
"OGM_PROJECT_ID": "{env:OGM_PROJECT_ID}",
"OGM_PERMISSION_PROFILE": "{env:OGM_PERMISSION_PROFILE}"
},
"enabled": true
}
}
}
Restart OpenCode after editing config.
Hermes
Add server under mcp_servers:
mcp_servers:
ogm:
command: "uvx"
args:
- "ogm-agent-bridge==0.1.7"
env:
OGM_BASE_URL: "${OGM_BASE_URL}"
OGM_API_KEY: "${OGM_API_KEY}"
OGM_PROJECT_ID: "${OGM_PROJECT_ID}"
OGM_PERMISSION_PROFILE: "${OGM_PERMISSION_PROFILE}"
enabled: true
Verify:
hermes mcp test ogm
For source development, replace uvx ogm-agent-bridge==0.1.7 with:
uv run --project /absolute/path/ogm-agent-bridge ogm-agent-bridge
MCP uses stdio. Diagnostics go to stderr.
Use
After MCP server is connected, ask your agent to use OGM tools. Start with health and dataset discovery:
Call ogm_health, then ogm_list_datasets.
Search entities in one dataset:
{"dataset_id":"dataset-id","q":"OpenGraphMemory","limit":10}
Inspect graph context with ogm_get_entity, ogm_get_neighbors, ogm_get_subgraph, ogm_get_graph, or ogm_find_path. Use ogm_get_relation_evidence or ogm_get_evidence before making evidence-backed claims.
Retrieve relevant operational experience with ogm_memory_search. Create an episode, append attempts, and record a verified outcome only when profile is personal-safe. Feedback and supersession require memory-curator.
Upload documents only when profile is personal-safe and file path is under OGM_UPLOAD_ROOTS:
Call ogm_upload_document with an approved local file path and dataset/project context.
More Docs
Validation
uv sync --dev --locked
uv run ruff format --check .
uv run ruff check .
uv run mypy src
uv run pytest -q
uv build
Security
Use project-scoped keys. Keep .env and keys outside upload roots. Start read-only; use personal-safe only for reviewed writes; reserve memory-curator for memory governance. See security.
License
MIT. See LICENSE.
Metadata
Release files for ogm-agent-bridge 0.1.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ogm_agent_bridge-0.1.7.tar.gz | 94.4 kB | Without provenance | Details for ogm_agent_bridge-0.1.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ogm_agent_bridge-0.1.7-py3-none-any.whl | Python 3 | none | any | Details for ogm_agent_bridge-0.1.7-py3-none-any.whl |
Total release size: 116.1 kB
Release files / ogm_agent_bridge-0.1.7.tar.gz
| Download URL | ogm_agent_bridge-0.1.7.tar.gz |
|---|---|
| Size | 94.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
04701e15707416e9c2966327623c2c897b987a6e1814d3113e7d801f15688040
|
|
BLAKE2b-256 checksum How to use checksums |
78e170bf6225b74325bfbac235430672e92216928426861c7a5b9705e30d3757
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Release files / ogm_agent_bridge-0.1.7-py3-none-any.whl
| Download URL | ogm_agent_bridge-0.1.7-py3-none-any.whl |
|---|---|
| Size | 21.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
74bda8529c33d0ac7881857e5af81f19fb77a4f0d826ce0c25510130915a629e
|
|
BLAKE2b-256 checksum How to use checksums |
7febb73e802fae1c43f1e18aa111541ec5d55451a4b9259552c87ab722bd553a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Security for ogm-agent-bridge 0.1.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.