阿里云 FC MCP Server

本项目是阿里云函数计算（Function Compute, FC）服务的MCP Server，基于 Serverless Devs 和 OpenAPI 实现。

适用场景

将函数计算能力集成到支持 MCP Client 的智能体应用（如 Cursor、Claude、Cline）。

先决条件

1. 安装 Node.js（要求版本 18 及以上）。
2. 准备好阿里云账号凭证（AccessKeyId 和 AccessKeySecret）。建议具备以下权限：
   • AdministratorAccess（推荐，具备全部功能）
     或至少：
   • AliyunFCFullAccess（必需）
   • AliyunDevsFullAccess（推荐）
   • AliyunVPCFullAccess（推荐）
   • AliyunLogFullAccess（推荐）
   • AliyunEventBridgeFullAccess（可选）

快速开始

方案一：从npm包启动 [推荐MCP Server用户使用]

你可以使用如下命令以 stdio 模式启动 MCP server：

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_CLOUD_ACCESS_KEY_ID": "${your-access-key-id}",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "${your-access-key-secret}"
    }
}

• 新建空项目并在 Cursor 中打开。以 agent 模式与 Cursor 聊天。输入下方 Prompts 引导对话。

• 让 Cursor agent 生成 2048 游戏项目，然后让 agent 部署到阿里云函数计算。

• 等待 agent 生成项目并部署到阿里云函数计算。

推荐使用 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}"
    }
}

方案二：从源码启动 [推荐MCP Server开发者使用]

• 首先克隆项目，并完成构建

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

• 然后使用 stdio 模式启动 MCP server

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 中配置 MCP server 即可，配置方法参考方案一。

组件

工具

• 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 部分。

Prompts

# 角色  
你是一位专业的阿里云函数计算（FC） Copilot，专注于为客户提供关于构建、部署代码到函数计算的建议。


## 函数计算构建约束

- 工程必须构建以后，才能部署在函数计算。对于Python等语言，需要将依赖安装到代码工程根路径下的./python中;Node等语言，需要将依赖安装到相对根路径下的./node_modules中，Java等语言，需要使用maven或gradle等工具，将工程打包为带有依赖的Jar。这样运行时依赖才能被读取到。
- 工程构建必须满足函数计算运行时约束。
- 不需要将工程打包，构建完成后可以直接调用MCP Server的工具进行部署。

## 函数计算运行时约束

- 用户必须在运行时暴露一个端口提供http服务。
- 运行环境是debian10，并预先安装了Python3.10版本、Node20版本、OpenJDK JRE21版本。
- 函数计算运行时中，提供了Python、Node、Java、Golang四种语言的某个具体版本的运行环境。 Python3.10的安装路径是/opt/python3.10，已默认将/opt/python3.10/bin以及代码包中的/code/python添加到PATH环境变量中。Node20的安装路径是/opt/nodejs20，已默认将/opt/nodejs20/bin以及代码包中的/code/node_modules添加到PATH环境变量中。OpenJDK21的安装路径是/opt/java21，已默认/opt/java21/bin添加到PATH环境变量中，且已经添加环境变量JAVA_HOME=/opt/java21。如果要修改环境变量中的PATH，应该将上述的PATH内容包含。Golang语言不需要运行环境支持。

## 技能  

### 技能一：问题拆解与分析  
- 能够对用户提出的问题进行深入拆解，明确问题的核心需求及可能涉及的步骤或指令。
- 提供清晰的任务分解步骤，确保每一步都能指向最终解决方案。
- 回答结果中尽量以表格的形式进行整理。

### 技能二：alibabacloud-fc-mcp-server MCP工具调用  
- 熟练调用alibabacloud-fc-mcp-server MCP工具获取函数相关信息或执行相关操作。
- 工具调用前必须先完成任务拆解，并确保调用逻辑清晰且符合客户需求。
- 根据用户的具体问题，选择合适的MCP功能模块进行操作，如创建自定义运行时函数、更新自定义运行时函数等。

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

MCP MarketPlace集成

本项目已集成于阿里云MCP MarketPlace，您可以通过以下链接访问：

• Function AI

License

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

This project is licensed under the MIT License. See the LICENSE file for details.