MCP Any Rest

🚀 MCP-ANY-REST

AIが急速に発展する今日、大規模言語モデル（LLM）は驚くべき能力を発揮しています。しかし、LLMを安全かつ効率的に既存の膨大な業務システム（REST API）に接続することは、依然として課題となっています。

MCP-ANY-REST はこのような背景の中で生まれました。私たちの使命は、LLMと業務データ間の壁を取り除くこと です。

私たちは単なるツールを構築しているのではなく、AIが現実世界のデータを理解し操作できるようにする橋を架けています。Model Context Protocol（MCP）標準に従うことで、任意のRESTfulサービスをゼロコストでAIエコシステムに接続できます。

✨ 主な機能

• ZML 配置：ゼロコストモジュール言語（ZML）を使用した宣言的な設定
• トークン認証：安全なトークンベースの認証
• サービスオーケストレーション：ServiceComposerによる統一インターフェースの提供
• RMCP 準拠：RMCPプロトコル標準に完全に準拠

📦 インストール

前提条件

• Rust 1.70+ (2021 edition)
• APIアクセス権を持つRESTサービス（ZenTaoの例をサポート）
• 環境変数の設定

インストール手順

1. リポジトリをクローンします：

git clone <repository-url>
cd mcp-any-rest

2. プロジェクトをビルドします：

提供されているビルドスクリプトを使用すると、zml と mcp-any-rest のバイナリファイルを同時にビルドし、配布パッケージを作成できます。

• Windows:

.\build_and_copy.bat

• Linux/macOS:

./build_and_copy.sh

または、cargoを使用して手動でビルドすることもできます：

cargo build --release

💻 使用例

サーバーの起動

サーバーは現在、柔軟な設定ディレクトリ管理をサポートしています：

• コマンドラインで指定：--config-dir を使用してカスタム設定ディレクトリを指定します
• 自動検出：設定ディレクトリが指定されていない場合、サーバーは実行ファイルに対する config ディレクトリを自動的に使用します

# カスタム設定ディレクトリを使用して実行
cargo run --bin mcp-any-rest -- --transport http --config-dir /path/to/your/config

# stdioモードで実行（実行ファイルに対する設定ディレクトリを使用）
cargo run --bin mcp-any-rest -- --transport stdio

# リリースモードでカスタム設定ディレクトリを使用して実行
cargo run --release --bin mcp-any-rest -- --transport http --config-dir ./my-config

# デフォルト設定を使用して実行（設定ディレクトリは実行ファイルに対するもの）
./target/release/mcp-any-rest --transport http

ZMLコマンドラインツール

このプロジェクトには、ZMLモジュールを管理するための zml コマンドラインツールが含まれています。

# モジュールをリストする
cargo run --bin zml -- list

# ZMLをJSONにコンパイルする
cargo run --bin zml -- compile -i config/zml/project.zml --pretty

詳細については、docs/ZML_QUICKSTART.md を参照してください。

設定ディレクトリ構造

設定ディレクトリには、以下のファイルが含まれている必要があります：

config/
├── config.json                  # サーバーの実行時設定
├── modules.json                 # モジュールの有効化マッピング
└── presets/                     # 事前設定されたモジュールセット
    ├── full.json
    ├── index.json
    └── ...

📚 ドキュメント

ZMLドキュメント

docs/ ディレクトリ内のZMLドキュメントインデックスを参照してください：

• インデックス：docs/README.md
• 仕様：docs/ZML_SPECIFICATION.md
• クイックスタート：docs/ZML_QUICKSTART.md
• 認証設定：docs/ZML_AUTHORIZATION.md

技術スタック

このプロジェクトは、高性能と保守性を確保するために最新の技術スタックで構築されています：

プロジェクト構造

config/                         # 実行時設定とZMLソースコード
├── config.json                  # サーバーの実行時設定
├── modules.json                 # モジュールの有効化マッピング
├── presets/                     # 事前設定されたモジュールセット
│   ├── full.json
│   ├── index.json
│   └── project.json
└── zml/                         # ZMLモジュール定義 (ソースコード)
    ├── project.zml
    ├── user.zml
    └── ...
src/
├── lib.rs                       # ライブラリのエクスポート
├── main.rs                      # メインエントリポイント
├── zml/                         # ZML言語の実装
│   ├── mod.rs
│   ├── ast.rs                   # 抽象構文木
│   ├── parser.rs                # ZMLパーサー
│   ├── compiler.rs              # ZMLコンパイラ (ZML → JSON)
│   └── grammar.pest             # PEG構文
├── services/                    # サービスオーケストレーション
│   ├── mod.rs
│   └── composer_service/
│       └── module_registry.rs
└── bin/                         # CLIとテストツール
    ├── zml.rs                   # 統一ZML CLI (list, compile)
    ├── test_zml.rs              # ZMLコンパイル/統合テスト
    └── ...
docs/                            # ZML仕様とドキュメント
├── README.md                    # ドキュメントインデックス
├── ZML_SPECIFICATION.md         # ZML言語仕様
├── ZML_QUICKSTART.md            # クイックスタートガイド
└── ZML_AUTHORIZATION.md         # 認証設定
plugin/
├── vscode-zml/                  # ZML構文のVSCode拡張
│   ├── README.md
│   └── syntaxes/zml.tmLanguage.json
└── web-docs/                    # Webドキュメント
tests/
├── zml_enum_tests.rs
└── zml_integration_test.rs

🔧 技術詳細

新しいサービスの追加

ZMLベースのアーキテクチャを使用して新しいサービスモジュールを追加するには：

1. config/zml/ 内に新しいZMLモジュール定義ファイル（例：config/zml/mymodule.zml）を作成します
2. ZML構文を使用してモジュールの構造、メソッド、および型を定義します
3. システムは実行時に自動的にこのモジュールをロードし登録します
4. サービスオーケストレーション層のコードは変更する必要がありません

テスト

テストを実行するには：

cargo test

本番用ビルド

cargo build --release

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。

コントリビューション

1. リポジトリをForkする
2. 機能ブランチを作成する
3. 変更をコミットする
4. テストを追加する
5. Pull Requestを送信する

サポート

問題や質問がある場合は、GitHubリポジトリにissueを登録してください。