<p align="center"><b>English</b> | <a href="./README_CN.md">中文</a><br></p>

阿里云函数计算MCP服务器

该项目是阿里云函数计算（FC）服务的MCP服务器，基于Serverless Devs和OpenAPI。

使用场景

将阿里云函数计算的能力集成到支持MCP客户端的应用程序中（如Cursor、Claude、Cline）。

先决条件

1. 安装Node.js（需要版本18或以上）。
2. 准备您的阿里云凭证（AccessKeyId 和 AccessKeySecret）。推荐以下权限：
   • AdministratorAccess（推荐用于全部功能），或者至少：
   • AliyunFCFullAccess（必需）
   • AliyunDevsFullAccess（推荐）
   • AliyunVPCFullAccess（推荐）
   • AliyunLogFullAccess（推荐）
   • AliyunEventBridgeFullAccess（可选）

快速开始

方法1：从npm包开始 [推荐给MCP服务器用户]

您可以使用以下命令以stdio模式启动MCP服务器：

ALIBABA_CLOUD_ACCESS_KEY_ID=${your-access-key-id} ALIBABA_CLOUD_ACCESS_KEY_SECRET=${your-access-key-secret} npx alibabacloud-fc-mcp-server

使用 Cursor [推荐]

• 点击 或编辑Cursor配置文件（文档），并添加以下配置：

"alibabacloud-fc-mcp-server": {
    "command": "npx",
    "args": ["-y", "alibabacloud-fc-mcp-server"],
    "env": {
        "ALIBABA_CCloud_ACCESS_KEY_ID": "${your-access-key-id}",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "${your-access-key-secret}"
    }
}

• 创建一个新的空项目，并在Cursor中打开它。以代理模式与Cursor聊天。输入以下Prompts来引导对话。

• 要求Cursor代理生成一个2048游戏项目，然后要求代理将其部署到阿里云函数计算。

• 等待代理生成项目并将其部署到阿里云函数计算。

使用 Cline

编辑Cline配置文件（文档），并添加以下配置：

"alibabacloud-fc-mcp-server": {
    "command": "npx",
    "args": ["-y", "alibabacloud-fc-mcp-server"],
    "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "${your-access-key-id}",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "${your-access-key-secret}"
    }
}

方法2：从源代码开始 [推荐给MCP服务器开发者]

• 首先，克隆项目并构建：

git clone https://github.com/alibaba/alibabacloud-fc-mcp-server.git
cd alibabacloud-fc-mcp-server
npm install
npm run build

• 然后以stdio模式启动MCP服务器：

ALIBABA_CLOUD_ACCESS_KEY_ID=${your-access-key-id} ALIBABA_CLOUD_ACCESS_KEY_SECRET=${your-access-key-secret} node {absolute-path-to-project}/build/index.js

• 最后，在Cursor或Cline中按照方法1配置MCP服务器。

组件

工具

• put-custom-runtime-function: 打包符合阿里云自定义运行时要求的项目，创建一个函数，并将代码部署到该函数。如果函数已存在，则会尝试覆盖并更新目标函数。建议在使用此方法之前检查函数是否存在，并确认更新。
• update-custom-runtime-function: 更新自定义运行时函数。仅更新提供的参数；其他参数保持不变。
• get-function: 获取指定函数的详细信息。
• list-functions: 列出指定区域内的所有函数，返回仅函数名称和部分信息。要获取完整详情，请使用get-function。
• delete-function: 删除指定函数。
• get-custom-domain-config: 查询自定义域名路由配置。
• update-custom-domain-config: 更新自定义域名路由配置。
• create-custom-domain-config: 创建自定义域名路由配置。域名必须已经CNAME到公共函数计算域名（格式：${uid}.${regionId}.fc.aliyuncs.com，例如14**49.cn-hangzhou.fc.aliyuncs.com），否则无法创建。
• delete-custom-domain-config: 删除自定义域名路由配置。
• get-custom-runtime-prompt: 获取自定义运行时提示。未来将移动到Prompts。

提示

# 角色
您是一位专业的阿里巴巴云函数计算（FC）副驾，专注于为客户提供关于如何构建和部署代码到函数计算的建议。

## 函数计算构建约束

- 在部署到函数计算之前，项目必须被构建。对于Python这样的语言，依赖项应在项目根目录下的./python中安装；对于Node，依赖项应在项目根目录下的./node_modules中安装；对于Java，应使用Maven或Gradle将项目打包成包含依赖项的Jar。这确保了运行时依赖项可以找到。
- 项目的构建必须满足函数计算的运行时约束。
- 您不需要打包项目；构建完成后，可以直接使用MCP服务器工具进行部署。

## 函数计算运行时约束

- 用户必须暴露一个端口以提供HTTP服务。
- 运行环境是debian10，预装了Python 3.10、Node 20和OpenJDK JRE 21。
- 函数计算提供了特定的运行时环境，包括Python、Node、Java和Golang。Python 3.10安装在/opt/python3.10，/opt/python3.10/bin以及代码包中的/code/python默认添加到PATH环境变量中。Node 20安装在/opt/nodejs20，/opt/nodejs20/bin以及代码包中的/code/node_modules默认添加到PATH中。OpenJDK 21安装在/opt/java21，/opt/java21/bin默认添加到PATH中，JAVA_HOME设置为/opt/java21。如果您修改了PATH，请确保包含上述内容。Golang不需要运行时环境。

## 技能

### 技能1：问题分解与分析
- 能够深入地分解用户的问题，明确核心需求及可能涉及的步骤或命令。
- 提供清晰的任务分解步骤，确保每一步都导向最终解决方案。
- 尽可能地以表格形式组织答案。

### 技能2：alibabacloud-fc-mcp-server MCP工具使用
- 熟练使用alibabacloud-fc-mcp-server MCP工具来获取函数信息或执行相关操作。
- 在调用工具之前必须完成任务分解，确保逻辑清晰且满足客户需求。
- 根据用户的特定问题选择合适的MCP模块，如创建或更新自定义运行时函数。

## 约束
- **任务分解优先**：首先提供详细的任务分解步骤。
- **清晰的工具依赖**：所有需要调用MCP工具的操作都应基于清晰的任务需求和逻辑推理。
- **代码生成与构建**：代码必须在本地构建，然后才能部署并在函数计算上运行。代码生成和构建必须满足函数计算的构建和运行时约束。

MCP市场集成

该项目已集成到阿里云MCP市场。您可以通过以下链接访问：

• 函数AI

许可证

本项目基于MIT许可证开源。详情参见LICENSE文件。