MCP Any Rest

🚀 MCP-ANY-REST

在當今人工智能飛速發展的時代，大語言模型（LLM）展現出了驚人的能力。然而，如何讓 LLM 安全、高效地連接到現有的海量業務系統（REST APIs），一直是一個極具挑戰性的問題。

MCP-ANY-REST 正是為解決這一問題而誕生。我們的使命是消除 LLM 與業務數據之間的隔閡。

我們不僅僅是在開發一個工具，更是在搭建一座橋樑，一座讓 AI 能夠理解並操作現實世界數據的橋樑。通過遵循 Model Context Protocol (MCP) 標準，我們讓任何 RESTful 服務都能零成本接入 AI 生態。

🚀 快速開始

前置要求

• 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

# 在 release 模式下使用自定義配置目錄運行
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 配置：使用零成本模塊語言 (ZML) 進行聲明式配置
• 令牌認證：安全的基於令牌的認證
• 服務編排：通過 ServiceComposer 提供統一接口
• RMCP 合規：完全符合 RMCP 協議標準

📦 安裝指南

克隆倉庫

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

構建項目

使用腳本構建

• Windows:

.\build_and_copy.bat

• Linux/macOS:

./build_and_copy.sh

手動構建

cargo build --release

💻 使用示例

運行服務器

# 使用自定義配置目錄運行
cargo run --bin mcp-any-rest -- --transport http --config-dir /path/to/your/config

# 在 stdio 模式下運行（使用相對於可執行文件的配置目錄）
cargo run --bin mcp-any-rest -- --transport stdio

# 在 release 模式下使用自定義配置目錄運行
cargo run --release --bin mcp-any-rest -- --transport http --config-dir ./my-config

# 使用默認配置運行（配置目錄相對於可執行文件）
./target/release/mcp-any-rest --transport http

ZML 命令行工具

# 列出模塊
cargo run --bin zml -- list

# 編譯 ZML 為 JSON
cargo run --bin zml -- compile -i config/zml/project.zml --pretty

📚 詳細文檔

ZML 文檔

查看 docs/ 目錄下的 ZML 文檔索引：

• 索引：docs/README.md
• 規範：docs/ZML_SPECIFICATION.md
• 快速開始：docs/ZML_QUICKSTART.md
• 授權配置：docs/ZML_AUTHORIZATION.md

VSCode 擴展

plugin/vscode-zml 中提供了一個用於 ZML 語法高亮和格式化的 VSCode 擴展。

安裝說明請參閱 plugin/vscode-zml/README.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

🔧 技術細節

核心價值

::: tip Write Once, Connect Anywhere 無需為每個 AI 模型重複開發接口。一次配置，處處運行。 :::

技術棧

本項目基於現代化的技術棧構建，確保高性能與可維護性：

開發

添加新服務

要使用基於 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。