Harbor

Harbor is a robust TypeScript gateway designed for seamless integration between AI clients and existing backend APIs, leveraging the Model Context Protocol (MCP) without any alterations to those APIs. This production-grade solution addresses the complexities AI encounters when interfacing with backend services, offering a streamlined approach to manage API interactions efficiently.

Key Features

• General-Purpose Tools: Harbor provides five essential MCP tools: discover_services, discover_skills, get_skill_details, search_code, and api_execute, thereby minimizing the need for multiple endpoint-specific tools.

• V8 Sandbox Isolation: Ensures that any AI-generated JavaScript code operates in a secure sandbox environment, preventing unauthorized access to network or filesystem resources.

• Flexible Authentication: Supports pluggable authentication options including static-token, oauth-introspection, jwt-validation, and oauth-2.1, catering to a variety of security requirements.

• Circuit Breaker Mechanism: Protects services with a count-based circuit breaker specifically designed per endpoint and service to maintain stability.

• Structured Audit Logging: Comprehensive logging for every api_execute call, recording code, endpoints, duration, and outcomes for easier traceability and troubleshooting.

• Zero API Modifications: Functions as a pure adapter, allowing the existing API infrastructure to remain untouched while facilitating advanced AI interactions.

• Streamlined HTTP and Standard I/O Support: Offers compatibility with both MCP transport methods, enhancing flexibility and usage scenarios.

Architectural Overview

The architecture of Harbor ensures that the AI client communicates effectively through the gateway without needing prior knowledge of the underlying APIs. The flow is illustrated below:

AI client  →  Harbor  →  Your backend APIs
                    │
                    ├── V8 sandbox isolation
                    ├── Per-service auth (OAuth 2.1 / static token)
                    ├── Circuit breaker + retry
                    └── Audit logging

This model not only minimizes the burden on the AI to manage intricate details about backend APIs but also enhances the overall robustness and maintainability of the system.

Comprehensive Documentation

Harbor is accompanied by thorough documentation covering setup, service onboarding, skill authoring, configuration options, and guidance on developing custom connectors. Detailed documentation is available in various sections, ensuring developers have easy access to the information they need for successful implementation.

By employing Harbor, organizations can effectively bridge the gap between AI and backend systems, enabling innovative interactions without the complexities associated with traditional API integrations.