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 许可证