{"id":35214535,"url":"https://github.com/apocys/mcp-connector-platform","last_synced_at":"2026-04-18T17:36:43.049Z","repository":{"id":328962335,"uuid":"1117528629","full_name":"apocys/mcp-connector-platform","owner":"apocys","description":"Transform OpenAPI documentation into hosted MCP servers with governance controls and Gemini AI safety review","archived":false,"fork":false,"pushed_at":"2025-12-16T15:31:50.000Z","size":93,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-20T03:15:58.824Z","etag":null,"topics":["ai-safety","gemini","governance","mcp","openapi"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apocys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"docs/GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-16T12:47:35.000Z","updated_at":"2025-12-16T15:31:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/apocys/mcp-connector-platform","commit_stats":null,"previous_names":["apocys/mcp-connector-platform"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/apocys/mcp-connector-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apocys%2Fmcp-connector-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apocys%2Fmcp-connector-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apocys%2Fmcp-connector-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apocys%2Fmcp-connector-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apocys","download_url":"https://codeload.github.com/apocys/mcp-connector-platform/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apocys%2Fmcp-connector-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31978548,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T17:30:12.329Z","status":"ssl_error","status_checked_at":"2026-04-18T17:29:59.069Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-safety","gemini","governance","mcp","openapi"],"created_at":"2025-12-29T21:20:34.651Z","updated_at":"2026-04-18T17:36:43.038Z","avatar_url":"https://github.com/apocys.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Connector Platform\n\nA web platform that transforms OpenAPI documentation into hosted MCP (Model Context Protocol) servers with built-in governance controls and AI-powered safety review.\n\n## Overview\n\nThis platform enables users to:\n- Import OpenAPI specifications (JSON/YAML)\n- Generate MCP server definitions automatically\n- Deploy connectors with governance controls\n- Review and approve tool invocations with AI assistance\n- Monitor usage and maintain audit logs\n\n## Architecture\n\nThe platform consists of four main components:\n\n### 1. Backend (Control Plane API)\n- User and organization management\n- Connector configuration storage\n- Governance rule management\n- MCP token lifecycle\n- Approval workflow\n- Audit logging\n\n### 2. Frontend (Admin UI)\n- Connector creation and management\n- Endpoint selection interface\n- Governance rule configuration\n- Approval queue\n- Usage logs and analytics\n\n### 3. MCP Runtime\n- HTTP-based MCP server implementation\n- Tool execution with governance checks\n- AI Reviewer integration\n- Request/response logging\n- Error handling and fallbacks\n\n### 4. Shared Utilities\n- OpenAPI parser\n- Governance engine\n- AI Reviewer client\n- Schema validation\n- Encryption utilities\n\n## Project Structure\n\n```\nmcp-connector-platform/\n├── backend/              # Node.js/Express control plane\n├── frontend/             # React admin UI\n├── mcp-runtime/          # MCP server runtime\n├── shared/               # Shared utilities and types\n└── README.md             # This file\n```\n\n## Quick Start\n\n### Prerequisites\n- Node.js 18+\n- PostgreSQL 13+\n- npm or pnpm\n\n### Installation\n\n```bash\n# Backend setup\ncd backend\nnpm install\nnpm run setup:db\nnpm run dev\n\n# Frontend setup (in another terminal)\ncd frontend\nnpm install\nnpm run dev\n\n# MCP Runtime setup (in another terminal)\ncd mcp-runtime\nnpm install\nnpm run dev\n```\n\n## Key Features\n\n### Point 6: Data Storage\n- Users and organizations\n- Connector configurations with encrypted secrets\n- Selected endpoints and tool definitions\n- Governance rules (JSON-based)\n- Deployment status and metadata\n- Invocation logs with decision tracking\n- Approval requests and history\n\n### Point 7: Core APIs\n- `POST /api/connectors` - Create connector from OpenAPI\n- `GET /api/connectors/:id/preview` - Preview generated tools\n- `PATCH /api/connectors/:id/endpoints` - Update endpoint selection\n- `PATCH /api/connectors/:id/governance` - Update governance rules\n- `POST /api/connectors/:id/deploy` - Deploy connector\n- `POST /api/tokens` - Issue MCP tokens\n- `DELETE /api/tokens/:id` - Revoke tokens\n- `GET /api/logs` - List invocation logs\n- `POST /api/approvals/:id/approve` - Approve pending action\n- `POST /api/approvals/:id/reject` - Reject pending action\n\n### Point 8: Minimal Configuration\nUsers only need to provide:\n- OpenAPI file or URL\n- Base URL (auto-detected)\n- Auth token/key (one field)\n- Click deploy\n\nEverything else defaults safely.\n\n### Point 10: Delivery\n- Hosted environment with deployment scripts\n- Admin UI for management\n- MCP runtime for execution\n- Demo connector example\n- Comprehensive documentation\n\n### Point 11: Implementation\n- Single backend with modular design\n- Parser module for OpenAPI\n- Governance module for rule evaluation\n- MCP runtime routes\n- Database-backed approval flow\n\n### Point 12: AI Reviewer\nOptional AI-powered safety layer that:\n- Assesses tool invocation requests\n- Returns: ALLOW, REQUIRE_HUMAN_APPROVAL, or BLOCK\n- Evaluates intent and plausibility\n- Identifies hallucinations\n- Provides risk scoring\n- Integrates with approval workflow\n\n## Governance Framework\n\n### Deterministic Checks\n- Domain lock (SSRF protection)\n- Rate limiting (per token)\n- Endpoint allowlist (verbs + paths)\n- JSON schema validation\n- Numeric ceiling enforcement\n\n### AI Reviewer (Optional)\n- Risk assessment (0-100 score)\n- Intent validation\n- Hallucination detection\n- Prompt injection resistance\n- Configurable thresholds\n\n### Default Safe Configuration\n- GET-only endpoints exposed\n- WRITE tools disabled by default\n- Rate limiting enabled\n- Logging enabled\n- AI Reviewer in ENFORCING mode\n\n## Deployment\n\n### Option 1: Docker\n```bash\ndocker-compose up\n```\n\n### Option 2: Manual\n```bash\n# Backend\ncd backend \u0026\u0026 npm run build \u0026\u0026 npm start\n\n# Frontend\ncd frontend \u0026\u0026 npm run build \u0026\u0026 npm run serve\n\n# MCP Runtime\ncd mcp-runtime \u0026\u0026 npm run build \u0026\u0026 npm start\n```\n\n## Testing with Claude\n\n1. Deploy a connector\n2. Copy the MCP Server URL and token\n3. In Claude, go to Custom Connectors\n4. Paste the URL\n5. Add the token as Authorization header\n6. Test a tool call\n\n## Documentation\n\n- [Backend API Documentation](./backend/README.md)\n- [Frontend Setup Guide](./frontend/README.md)\n- [MCP Runtime Guide](./mcp-runtime/README.md)\n- [Governance Rules](./docs/GOVERNANCE.md)\n- [AI Reviewer Configuration](./docs/AI_REVIEWER.md)\n\n## Implementation Status\n\n- [x] Point 6: Data models and storage schema\n- [x] Point 7: Core API endpoints\n- [x] Point 8: Minimal configuration flow\n- [x] Point 9: Non-goals documentation\n- [x] Point 10: Delivery components\n- [x] Point 11: Modular backend architecture\n- [x] Point 12: AI Reviewer integration\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapocys%2Fmcp-connector-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapocys%2Fmcp-connector-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapocys%2Fmcp-connector-platform/lists"}