Skip to content

Add MCP server for ND 4.2 OpenAPI schema reference#183

Open
allenrobel wants to merge 2 commits intomasterfrom
feature/mcp-openapi-server
Open

Add MCP server for ND 4.2 OpenAPI schema reference#183
allenrobel wants to merge 2 commits intomasterfrom
feature/mcp-openapi-server

Conversation

@allenrobel
Copy link
Collaborator

Summary

  • Add a FastMCP-based MCP server that provides efficient, low-token access to ND 4.2 OpenAPI specifications
  • Server loads schema files from .claude/schemas/ and exposes 7 read-only tools for browsing, searching, and inspecting endpoints and schemas
  • Uses PEP 723 inline script metadata for zero-setup (uv run auto-installs dependencies)
  • Add user guide documentation

Files

  • .claude/mcp-servers/nd-openapi/server.py - MCP server implementation
  • .claude/schemas/.gitkeep - Schema directory (team drops OpenAPI files here)
  • .mcp.json - Project-scoped MCP server registration
  • docs/README_OPENAPI_SCHEMA_MCP_SERVER.md - User guide

Test plan

  • Place an OpenAPI JSON/YAML file in .claude/schemas/
  • Start Claude Code from project root, run /mcp to verify nd-openapi appears with 7 tools
  • Test get_api_info returns loaded file counts
  • Test list_tags, list_endpoints, search_endpoints return compact text
  • Test get_endpoint and get_schema return JSON with $ref resolved inline

🤖 Generated with Claude Code

allenrobel and others added 2 commits March 1, 2026 11:08
Provides a FastMCP-based MCP server that loads OpenAPI schema files
from .claude/schemas/ and exposes 7 tools for efficient, low-token
querying of endpoints, schemas, and tags. Uses PEP 723 inline deps
for zero-setup (uv run) across the team.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant