MCP ゲートウェイ – API およびセルフサービス ポータル

このリポジトリには、RBAC 認証とセルフサービス ポータルを使用して、安全かつスケーラブルで監査可能な方法でツール (内部 API) を公開、管理、使用するためのエンタープライズ ソリューションである MCP ゲートウェイが含まれています。

まとめ

• 概要

• フォルダ構造

• スピンの仕方（開発）

• 特徴

• RBAC構造の例

• 安全

• APIドキュメント

• システム要件

• 完全なドキュメント

• 優れた実践と観察

Related MCP server: Model Context Provider (MCP) Server

概要

MCP ゲートウェイは次の要素で構成されます。

• バックエンド: FastAPI + RBAC + JWT + JSON 永続性 (NoSQL 対応)

• **フロントエンド:**バックエンドと統合された React (Vite) を実行 ( /frontend/distにビルドされ、静的に提供される)

フォルダ構造

mcp-server/
├── app/                # Backend FastAPI
│   ├── main.py         # Entrypoint
│   ├── config.py       # Configurações
│   ├── auth.py         # Autenticação/JWT
│   ├── utils/          # Utilitários (RBAC, dependências)
│   └── groups/
│       ├── routes.py   # Rotas (APIs)
│       └── tools.py    # Utilitários de permissão
├── data/               # Dados persistentes
│   └── rbac.json       # Usuários, grupos, permissões
├── frontend/           # Portal React (Vite)
│   ├── src/            # Código-fonte React
│   └── dist/           # Build de produção (servido pelo FastAPI)
├── requirements.txt    # Dependências Python
├── README.md           # Este documento
└── ...

スピンの仕方（開発）

1. バックエンド（FastAPI）

python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload

2. フロントエンド（React）

cd frontend
npm install
npm run dev

次の URL にアクセスします: http://localhost:5173 (dev) またはhttp://localhost:8000 (prod)

3. 本番環境向けフロントエンドビルド

cd frontend
npm run build

ファイルはfrontend/distに生成されます。 FastAPI はこれらのファイルを自動的に提供できます。

特徴

• JWT ログイン (ユーザー、グループ管理者、グローバル管理者)

• グループ、ユーザー、ツール管理 (CRUD)

• グループ管理者によるツールの動的な作成

• ポータル経由のツールの安全な消費

• ヘルスチェック、登録、自動ドキュメント化（Swagger）

• NoSQL データベース統合と SSO に対応

RBAC構造の例

ユーザー、グループ、権限の例については、 data/rbac.jsonを参照してください。

安全

• JWT、RBAC、共有レジストリ

• CORS、HTTPS、レート制限などに対応しています。

APIドキュメント

Swagger の場合は/docsに、Redoc の場合は/redoc移動します。

システム要件

詳細な機能要件、非機能要件、およびビジネス要件については、 docs/REQUISITOS.mdファイルを参照してください。

完全なドキュメント

詳細なプロジェクトドキュメントは、 docs/フォルダに集中しています。

• docs/REQUISITOS.md : システム要件

• docs/API.md : エンドポイントと API の使用例

• docs/ARQUITETURA.md : 技術アーキテクチャ

• docs/SEGURANCA.md : セキュリティとベストプラクティス

• docs/GOVERNANCA.md : ガバナンスと役割

• docs/OPERACIONAL.md : 操作、監視、トラブルシューティング

• docs/CHANGELOG.md : バージョン履歴

優れた実践と観察

• 依存関係を最新の状態に保ちます。

• Python には仮想環境を使用します。

• 本番環境にデプロイする前に必ずフロントエンドを構築してください。

• docs/内の他のモジュールのドキュメントを確認してください。

• ヒント: 問題とプル リクエストを使用して変更を提案し、決定の履歴を維持します。

このドキュメントは、設計の変更を反映するために定期的に確認および更新する必要があります。