manifold

Manifold

One interface. Many connections. Manifold.

Manifold は MCP サーバーとして振る舞いながら、バックエンドで複数の外部 MCP サーバーや OpenAPI / Swagger 準拠の REST API へ接続するゲートウェイです。

Why "Manifold"?

Manifold（マニフォールド）はエンジンの吸気マニフォールドから来ています。

吸気マニフォールドは、エンジンの単一の入口から複数のシリンダーへ、均等かつ効率的に空気と燃料を分配する部品です。このプロジェクトの構造と似ていることから Manifold と名付けました。

アーキテクチャ

MCP Client
    │
    ▼
┌─────────────┐
│   Manifold  │   ← このサーバー
└─────────────┘
    │       │
    ▼       ▼
External  OpenAPI / Swagger
MCP       REST API Server
Server

主な機能

• OpenAPI / Swagger → MCP 自動変換: OpenAPI 3.x / Swagger 2.x 仕様から MCP ツールを自動生成
• MCP バックエンド統合: 外部 MCP サーバーへの透過的なリバースプロキシ
• OAuth 2.1 サーバー: PKCE (S256) 対応の認証サーバーを内蔵
• 遅延接続: バックエンドへの接続を初回リクエスト時に確立（ゲートウェイ起動時のバックエンド依存性を排除）
• ストレージ選択可能: Redis または SQLite によるセッション・トークン管理

必要要件

• Go 1.26+
• Redis または SQLite（セッション管理用）

インストール

バイナリダウンロード

Releases から最新バイナリをダウンロードしてください。

ソースからビルド

git clone https://github.com/nonchan7720/manifold.git
cd manifold
go build -o manifold .

Docker

docker pull ghcr.io/nonchan7720/manifold:latest

使い方

起動

# バイナリ実行
manifold gateway

# ソースから実行
go run main.go gateway

# Docker
docker run -p 9999:9999 \
  -v $(pwd)/config.yaml:/etc/manifold/config.yaml \
  ghcr.io/nonchan7720/manifold:latest

Docker Compose（開発環境）

Redis を含む開発環境を一括起動します。

docker compose up -d

設定

設定ファイル（config.yaml）をカレントディレクトリまたは config/ サブディレクトリに配置します。 設定値には ${VAR} または ${VAR:-default} 形式の環境変数展開が使えます。

MCP バックエンドへの接続

外部 MCP サーバーを Manifold 経由で公開します。

gateway:
  port: 9999

mcpServers:
  my-mcp-server:
    transport: http
    url: http://localhost:8080/mcp

OpenAPI / Swagger バックエンドへの接続

OpenAPI 仕様から MCP ツールを自動生成します。

gateway:
  port: 9999

mcpServers:
  my-api:
    spec: https://example.com/api/openapi.json
    baseURL: https://example.com

OAuth 2.1 認証付きの OpenAPI バックエンド

gateway:
  port: 9999

mcpServers:
  my-api:
    spec: https://example.com/api/openapi.json
    baseURL: https://example.com
    oauth2:
      clientID: YOUR_CLIENT_ID
      clientSecret: YOUR_CLIENT_SECRET
      authURL: https://example.com/oauth/authorize
      tokenURL: https://example.com/oauth/token
      scopes:
        - read
        - write

redis:
  addrs:
    - "${REDIS_ADDRS:-localhost:6379}"
  db: ${REDIS_DB:-0}

設定リファレンス

gateway

mcpServers.<name>

mcpServers.<name>.oauth2

redis

sqlite

HTTP エンドポイント

Manifold が公開する HTTP エンドポイントの一覧です。

MCP

OAuth 2.1

開発

テスト

make test

Lint

make lint

ライセンス

MIT License