open-ai-mcp-adapter

Name: open-ai-mcp-adapter
Availability: InStock
Author: Ben Sammons

説明なし

GitHub

GitHubスター

ユーザー評価

未評価

フォーク

イシュー

閲覧数

お気に入り

README

OpenAI MCP Adapter

A powerful Electron-based desktop application that aggregates Model Context Protocol (MCP) servers and exposes them as OpenAI Custom Actions. This cross-platform application (Windows, Mac, Linux) provides a unified interface for managing multiple MCP servers and makes their tools accessible via a local REST API.

Features

🌐 MCP Server Management
- Add, edit, and remove MCP servers with different transport types (SSE, STDIO, HTTP)
- Real-time server status monitoring
- Granular control over tool exposure
- Auto-start and auto-restart capabilities
🔄 Unified REST API
- Automatic conversion of MCP tools to REST endpoints
- Local Fastify server with localhost-only access
- OpenAPI schema generation for ChatGPT custom actions
- Comprehensive request/response validation
🚇 Ngrok Integration
- Secure tunneling with custom domain support
- Automatic retry with exponential backoff
- Real-time connection status monitoring
- API key management
🛠️ Tool Management
- Enable/disable individual tools
- Detailed tool information and capabilities
- Tool-level configuration options
- Real-time tool status updates
📊 Monitoring & Logging
- Comprehensive logging system
- Real-time status updates
- Error tracking and reporting
- Performance metrics

Installation

Clone the repository:

git clone https://github.com/yourusername/open-ai-mcp-adapter.git
cd open-ai-mcp-adapter

Install dependencies:
```
npm install
```
Build the application:
```
npm run build
```
Start the application:
```
npm start
```

Development

Prerequisites

Node.js 18+
npm 8+
Electron development environment

Development Scripts

npm run dev - Start the application in development mode with hot reload
npm run build - Build the application
npm run watch - Watch for changes and rebuild
npm run lint - Run ESLint
npm run test - Run Jest tests
npm run clean - Clean build artifacts

Project Structure

├── src/                  # React frontend code
│   ├── components/       # UI components
│   ├── services/        # Frontend services
│   ├── types/           # TypeScript type definitions
│   └── utils/           # Utility functions
├── electron/            # Electron main process code
│   ├── mcp/            # MCP client implementations
│   ├── local-server/   # Fastify server implementation
│   ├── services/       # Backend services
│   └── utils/          # Backend utilities
└── package.json        # Project configuration

Architecture

The application follows a modular architecture with clear separation of concerns:

Frontend Layer (src/)
- React-based UI components
- Material-UI for styling
- Event-based state management
- Real-time updates
Backend Layer (electron/)
- MCP server management
- Local REST API server
- Ngrok integration
- Configuration persistence
Communication Layer
- IPC for frontend-backend communication
- Event system for real-time updates
- Type-safe message passing

Configuration

The application supports various configuration options:

MCP Server Configuration
- Server name and endpoint
- Transport type (SSE, STDIO, HTTP)
- Authentication settings
- Auto-start options
Ngrok Configuration
- API key
- Custom domain
- Tunnel options
- Retry settings
Local Server Configuration
- Port settings
- CORS configuration
- Rate limiting
- Security options