AgentHubAgentHub

Ontology Atlas MCP Setup & Guide

MCP ServerMCP RegistryOfficial

io.github.wlsdks/ontology-atlas · v0.13.0

Read and write one codebase ontology kept as Markdown in the repository.

View on MCP Registry ↗Repository ↗

Copy the install config on this page first, then verify docs and permissions upstream.

Overview

Read and write one codebase ontology kept as Markdown in the repository. Ontology Atlas is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.

Use cases

Code review & GitHubCursor essentials

AgentHub Verified AvailabilityTested & Ready

Automated pipeline validated install commands, protocol & client compatibility

Verified At2026-10-04
Install Snippets TestedCLI & JSON config syntax verified
Protocol Handshake ReadyComplies with JSON-RPC 2.0 specifications
Origin Registry ActiveSourced from official-mcp-registry
Verified ClientsClaude Code、Claude Desktop、Cursor 等
Security Tier: A+ 级 · 官方认证推荐 (A+)·Maintained by official/verified teams, audited for standard MCP protocol compliance.
No auto-generated install guide — see the source repository README.

Troubleshooting & Common ErrorsFAQ

Common connection errors and verified fixes for Ontology Atlas

Getting 'connection closed' or exit code 1 in Cursor / Claude Code for Ontology Atlas?

Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.

Fix Snippet
# Check binary path in terminal:
which npx
node -v
Getting 'spawn npx ENOENT' or 'command not found'?

The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).

Missing required environment variable or authentication failure?

Ontology Atlas requires environment variables (OATLAS_VAULT). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.

Fix Snippet
// .cursor/mcp.json 或 claude_desktop_config.json
{
  "env": {
    "API_KEY": "your_actual_key_here"
  }
}
Still not connecting? Read the MCP troubleshooting guide →

Tool Mock Playground

Sandbox

Ontology Atlas Tool Interface Simulation · Preview tool schema & outputs without local runtime

Sandbox Ready
fn: ontology_atlasExecute the core tool interface of Ontology Atlas
Request ArgumentsJSON Schema
{
  "target": "Ontology Atlas",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Parameters generated dynamically by Agent runtime
Agent Tool Output

Click 'Run Mock' above

to preview the raw response returned to the LLM

Env: AgentHub Virtual SandboxJSON-RPC 2.0

Decision Guide: Why & When to Use

Assess suitability before installing to save trial-and-error time

Best Suited For
  • PR review
  • Changelog generation
  • Cross-repo issue search
When NOT to Use
  • Replacing human security audit
  • Unauthorized repo access
Recommended Workflow Pairing:View Scenario →

Ontology Atlas + Scenario Prompt → Complete Agent Automation

MCP hands-on: install to visible results

Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.

Open tutorial →

Related resources

Often paired with

Keep exploring AgentHub

Most people compare similar tools or check scenario guides before installing—start here.

Browse more like thisSearch similarPick by scenarioPrompt playbooksMCP hands-onReviews & comparisons

Listing badge: put AgentHub on your site

Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.

PreviewListed on AgentHub: Ontology Atlas
HTML
<a href="https://myagenthub.cn/p/io.github.wlsdks/ontology-atlas" title="Listed on AgentHub: Ontology Atlas" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.github.wlsdks/ontology-atlas?lang=en" alt="Listed on AgentHub: Ontology Atlas" height="20" style="border:0"/>
</a>
Markdown (GitHub README)
[![Listed on AgentHub: Ontology Atlas](https://myagenthub.cn/badge/io.github.wlsdks/ontology-atlas?lang=en)](https://myagenthub.cn/p/io.github.wlsdks/ontology-atlas)

Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.

Unified Manifest

{
  "id": "io.github.wlsdks/ontology-atlas",
  "type": "mcp-server",
  "version": "0.13.0",
  "displayName": "Ontology Atlas",
  "description": "Read and write one codebase ontology kept as Markdown in the repository.",
  "repository": {
    "url": "https://github.com/wlsdks/ontology-atlas",
    "source": "github"
  },
  "homepage": "https://ontologyatlas.com",
  "distribution": {
    "packages": [
      {
        "registryType": "mcpb",
        "identifier": "https://github.com/wlsdks/ontology-atlas/releases/download/v1.2.0/ontology-atlas-mcp-0.13.0.mcpb",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "OATLAS_VAULT",
            "description": "The Markdown folder that holds the ontology — normally atlas/ inside the repository it describes."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.wlsdks/ontology-atlas",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.wlsdks%2Fontology-atlas/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
Ontology Atlas MCP Setup & Guide - AgentHub