# alibabacloud-fc-mcp-server

**Repository Path**: mirrors_aliyun/alibabacloud-fc-mcp-server

## Basic Information

- **Project Name**: alibabacloud-fc-mcp-server
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-30
- **Last Updated**: 2025-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

# 阿里云 FC MCP Server

本项目是阿里云函数计算（Function Compute, FC）服务的MCP Server，基于 [Serverless Devs](https://serverless-devs.com/docs/overview) 和 [OpenAPI](https://help.aliyun.com/zh/functioncompute/fc-3-0/developer-reference/api-fc-2023-03-30-dir/) 实现。

## 适用场景

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

## 先决条件

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

## 快速开始

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

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

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

#### 推荐使用 [Cursor](https://www.cursor.com/)
+ 点击[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=alibabacloud-fc-mcp-server&config=eyJjb21tYW5kIjoibnB4IC15IGFsaWJhYmFjbG91ZC1mYy1tY3Atc2VydmVyIiwiZW52Ijp7IkFMSUJBQkFfQ0xPVURfQUNDRVNTX0tFWV9JRCI6IiR7eW91ci1hY2Nlc3Mta2V5LWlkfSIsIkFMSUJBQkFfQ0xPVURfQUNDRVNTX0tFWV9TRUNSRVQiOiIke3lvdXItYWNjZXNzLWtleS1zZWNyZXR9In19)或者编辑 Cursor 配置文件（[文档](https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers)），添加如下配置：
```json
"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-config](./images/cursor-config.png)

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

![input-prompt](./images/input-prompt.png)

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

![chat-with-agent](./images/chat-with-agent.png)

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

![get-result](./images/get-result.png)

#### 推荐使用 [Cline](https://cline.ai/)
编辑 Cline 配置文件（[文档](https://cline.ai/docs/mcp-servers)），添加如下配置：
```json
"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开发者使用]

+ 首先克隆项目，并完成构建
```bash
git clone https://github.com/alibaba/alibabacloud-fc-mcp-server.git
cd alibabacloud-fc-mcp-server
npm install
npm run build
```

+ 然后使用 `stdio` 模式启动 MCP server

```bash
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

```markdown
# 角色  
你是一位专业的阿里云函数计算（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](https://functionai.console.aliyun.com/mcp/275)

## License

本项目基于 MIT License 开源。详情参见 [LICENSE](./LICENSE) 文件。

This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.