Refunc MCP Server

🚀 部署 Refunc MCP 服務器

本項目提供了 Refunc MCP 服務器的部署、函數創建、MCP 終點創建等一系列操作的詳細指南，幫助你快速搭建和使用 Refunc MCP 服務。

🚀 快速開始

📦 安裝指南

部署 Refunc

將所有 refunc 組件部署到 refunc-system 命名空間，可使用以下命令：

kubectl apply -f https://raw.githubusercontent.com/refunc/mcp-server/refs/heads/main/deploy/play-all-in-one.yaml

然後將 refunc 服務代理到本地：

kubectl port-forward svc/aws-api 8000:http --address 0.0.0.0 -n refunc-system
kubectl port-forward svc/mcp-server 8001:http --address 0.0.0.0 -n refunc-system

⚠️ 重要提示

此演示部署的數據不持久。

創建函數

使用 refunc-cli 創建一個函數，步驟如下：

pip install -U refunc-cli
mkdir mcp-demo && cd mcp-demo
rfctl init

初始化函數配置文件時，會有如下交互：

初始化函數配置文件在 /path/mcp-demo/lambda.yaml
名稱: mcp-demo
命名空間: refunc-system
選擇語言:
1 - Python
2 - Go
請選擇 1 或 2 [1]:
選擇運行時:
1 - python3.10
2 - python3.9
3 - python3.8
請選擇 1、2、3 [1]:

在 main.py 中編寫任何代碼，示例為輸出一條問候消息。然後使用以下命令創建函數：

AWS_DEFAULT_ENDPOINT=http://127.0.0.1:8000 rfctl create

⚠️ 重要提示

您需要一個 Python 3 環境。

創建 MCP 終點

編輯 lambda.yaml 文件如下所示：

metadata:
  name: mcp-demo
  namespace: refunc-system
spec:
  build:
    source: .
    manifest: requirements.txt
    language: python
    architecture: x86_64
  handler: main.lambda_handler
  timeout: 120
  runtime: "python3.10"
  concurrency: 1
  environment:
    ENV_TEST: TEST
#  url:
#    cors:
#      allowCredentials: true
#      allowHeaders: "*"
#      allowMethods: "*"
#      allowOrigins: "*"
#      exposeHeaders: "*"
#      maxAge: 300
  events:
    # - name: hourly
    #   type: cron
    #   mapping:
    #     cron: 0 * * * *
    #     location: Asia/Shanghai
    #     args:
    #       var1: value1
    #     saveLog: false
    #     saveResult: false
    - name: mcp
      type: mcp
      mapping:
        args:
          token: mcp-demo
          tools:
            - name: echo-hello
              desc: Echo a hello msg # 不能包含單引號
              schema:
                type: object
                properties: {}
                required: []
        saveLog: false
        saveResult: false

然後執行以下命令更新配置：

AWS_DEFAULT_ENDPOINT=http://127.0.0.1:8000 rfctl update-config

此示例的 MCP SSE 終點 URL 為：http://127.0.0.1:8001/refunc-system/mcp-demo/test/mcp-demo/sse

Refunc MCP SSE URL 路徑格式為：/namespace/<token-secret-name>/<token>/<func-name>/sse

💻 使用示例

MCP 事件規範

- name: mcp
  type: mcp # 事件類型必須是 mcp。
  mapping:
    args:
      token: mcp-demo # 您可以在 play-all-in-one.yaml 中找到的令牌機密名稱。
      tools: # mcp 工具數據結構
        - name: echo-hello
          desc: Echo a hello msg # 不能包含單引號
          schema:
            type: object
            properties: {}
            required: []
    saveLog: false
    saveResult: false

說明：

• type：指定事件類型為 mcp。
• args.token：指定要使用的令牌。
• args.tools：定義一組工具，每個工具包含名稱、描述和模式。

此配置允許您通過 HTTP 請求與 MCP 服務交互。