apcore-mcp-typescript

<div align="center"> </div>

Automatic MCP Server & OpenAI Tools Bridge for apcore.

Converts apcore module registries into Model Context Protocol (MCP) tool definitions and OpenAI-compatible function calling formats — zero boilerplate required.

• MCP Server — Expose apcore modules as MCP tools over stdio, Streamable HTTP, or SSE
• OpenAI Tools — Convert modules to OpenAI function calling format with strict mode support
• Schema Conversion — Inline $defs/$ref from Pydantic-generated JSON Schema
• Annotation Mapping — Map module annotations to MCP hints and OpenAI description suffixes
• Approval Mechanism — Built-in elicitation-based approval flow for sensitive tool executions
• Error Mapping — Sanitize internal errors for safe client-facing responses
• Dynamic Registration — Listen for registry changes and update tools at runtime
• Tool Explorer — Browser-based UI for browsing schemas and testing tools interactively
• CLI — Launch an MCP server from the command line
• Config Bus integration — Registers an mcp namespace with the apcore Config Bus; configure via unified apcore.yaml or APCORE_MCP_* env vars
• Error Formatter Registry — Registers an MCP-specific error formatter for ecosystem-wide consistent error handling

For full documentation, including Quick Start guides for both Python and TypeScript, visit: [https://aiperceivable.github.io/apcore-mcp/](https://aiperceivable.github.io/apcore-mcp/)

• Node.js >= 18.0.0
• apcore-js >= 0.15.1

npm install apcore-mcp

apcore-js is included as a direct dependency — no separate install needed.