Sas MCP Server

🚀 SAS MCP Server

SAS MCP Server 是一個模型上下文協議（MCP）服務器，用於在 SAS Viya 環境中執行 SAS 代碼。它為用戶提供了在特定環境下運行 SAS 代碼的便捷方式，提升了代碼執行的效率和靈活性。

✨ 主要特性

• 可在 SAS Viya 計算上下文中執行 SAS 代碼。
• 支持使用 PKCE 流程進行 OAuth2 身份驗證，保障系統的安全性。
• 基於 HTTP 的 MCP 服務器，與 MCP 客戶端兼容，方便不同客戶端的接入。

🚀 快速開始

前提條件

• 必需條件
  • Python 3.12+
  • uv 0.8+
  • 具備計算服務的 SAS Viya 環境
  • 為 MCP 設置 Viya 環境，具體可參考 configuration.md
• 可選條件
  • Docker，相關設置可參考 docker setup

📦 安裝指南

1. 克隆倉庫：

git clone <repository-url>
cd sas-mcp-server

2. 安裝依賴：

uv sync

注意：此操作默認會在項目根目錄下創建一個名為 .venv 的虛擬環境。如果由於某些原因虛擬環境未創建，請運行 uv venv，然後重新運行 uv sync。

💻 使用示例

基礎用法

1. 配置環境變量：

cp .env.sample .env

編輯 .env 文件並設置：

VIYA_ENDPOINT=https://your-viya-server.com

2. 啟動 MCP 服務器：

uv run app

服務器默認將在 http://localhost:8134/mcp 上可用。

可用工具

• execute_sas_code：執行 SAS 代碼片段並獲取執行結果（日誌和列表輸出）

MCP 客戶端配置

在您的 MCP 客戶端配置文件（例如 .vscode/mcp.json）中添加以下內容：

{
    "servers": {
        "sas-execution-mcp": {
            "url": "http://localhost:8134/mcp",
            "type": "http"
        }
    }
}

高級用法

通過 MCP 工具執行 SAS 代碼：

data work.students;
input Name $ Age Grade $;
datalines;
Alice 20 A
Bob 22 B
;
run;

proc print data=work.students;
run;

如需瞭解更多詳細信息、配置選項和部署選項，請參考 examples 文件夾並按照其中的說明操作。

🤝 貢獻代碼

項目維護者歡迎對本項目進行補丁和貢獻。請閱讀 CONTRIBUTING.md 以瞭解提交貢獻的詳細信息。

📄 許可證

除 /static 文件夾中的內容外，本項目採用 Apache 2.0 許可證 授權。/static 文件夾中的元素歸 SAS 所有，未在開源許可證下發布。SAS 以及其他所有 SAS Institute Inc. 的產品或服務名稱均為 SAS Institute Inc. 在美國和其他國家的註冊商標或商標。® 表示美國註冊。

使用 SAS 軟件（例如 SAS Viya）的單獨商業許可證不包含在此項目中，使用這些功能與 SAS 軟件配合使用時需要此類許可證。

所有引用的第三方商標均屬於其各自所有者，此處僅用於識別和參考目的，並不意味著得到商標所有者的任何關聯或認可。

本項目需要使用以下軟件：

• Python，其許可證請參考 此處
• FastMCP，採用 Apache 2.0 許可證
• uvicorn，採用 BSD 3 - 條款許可證
• starlette，採用 BSD 3 - 條款許可證
• httpx，採用 MIT 許可證