Malloy MCP Server

🚀 Malloy MCP 服務器

Malloy MCP 服務器是一個用於執行 Malloy 查詢和管理 Malloy 資源的 MCP 服務器實現，能幫助用戶高效處理 Malloy 相關任務。

🚀 快速開始

Malloy MCP 服務器能讓你輕鬆執行 Malloy 查詢和管理資源。下面將為你介紹其安裝、使用等相關步驟。

✨ 主要特性

• 通過 MCP 執行 Malloy 查詢
• 訪問 Malloy 項目、包和模型元數據
• 具有詳細上下文的強大錯誤處理
• 全面的測試覆蓋
• 類型安全實現

📦 安裝指南

# 使用 uv 安裝（推薦）
uv pip install malloy-mcp-server

# 或使用 pip
pip install malloy-mcp-server

💻 使用示例

基礎用法

啟動服務器

from malloy_mcp_server import mcp

# 運行服務器
if __name__ == "__main__":
    mcp.serve()

配置

服務器可以通過環境變量進行配置：

示例：

# 設置發佈者 URL
export MALLOY_PUBLISHER_ROOT_URL="http://malloy-publisher:4000"

# 使用自定義配置運行
python -m malloy_mcp_server

執行查詢

服務器提供了一個 MCP 工具用於執行 Malloy 查詢：

from malloy_mcp_server import ExecuteMalloyQueryTool

# 示例查詢執行
result = await ExecuteMalloyQueryTool(
    query="select * from users",
    model_path="my_package/users"
)

訪問資源

服務器提供了以下資源端點：

• malloy://project/home/metadata - 項目元數據
• malloy://project/home/package/{package_name} - 包元數據
• malloy://project/home/model/{model_path} - 模型元數據

🔧 技術細節

開發

設置

1. 克隆倉庫：

git clone https://github.com/namabile/malloy-mcp-server.git
cd malloy-mcp-server

2. 安裝依賴項：

uv pip install -e ".[dev]"

運行測試

# 運行所有測試
pytest

# 帶覆蓋率運行
pytest --cov=malloy_mcp_server

代碼質量

項目使用：

• black 進行代碼格式化
• mypy 進行類型檢查
• ruff 進行代碼檢查

運行質量檢查：

black .
mypy .
ruff check .

錯誤處理

服務器提供詳細的錯誤處理和上下文：

from malloy_mcp_server.errors import QueryExecutionError

try:
    result = await ExecuteMalloyQueryTool(...)
except QueryExecutionError as e:
    print(f"錯誤: {e.message}")
    print("上下文:", e.context)

架構

服務器基於以下構建：

• FastMCP 用於 MCP 服務器實現
• Malloy 發佈者客戶端 用於 Malloy 交互
• Pydantic 用於數據驗證

關鍵組件：

• server.py - 核心服務器實現
• tools/query_executor.py - 查詢執行工具
• errors.py - 錯誤處理實用程序

🤝 貢獻

1. 叉克隆倉庫
2. 創建功能分支
3. 進行修改
4. 為新功能添加測試
5. 提交拉取請求

📄 許可證

MIT License - 詳見 LICENSE 文件