Refunc MCP 服务器

部署 Refunc

在 refunc-system 命名空间中部署所有 refunc 组件。

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

Initing function manifest in /path/mcp-demo/lambda.yaml
Name: mcp-demo
Namespace: refunc-system
Select Language:
1 - python
2 - go
Choose from 1, 2 [1]:
Select Runtime:
1 - python3.10
2 - python3.9
3 - python3.8
Choose from 1, 2, 3 [1]:

# 在 main.py 中编写任何代码，此演示是回显一条 hello 消息。

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 端点是：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 中找到 token secret name。
      tools: # mcp 工具
        - name: echo-hello # mcp 工具名称
          desc: Echo a hello msg # mcp 工具描述
          schema: # mcp 工具参数，使用有效的 JSON Schema 描述。
            type: object
            properties: {}
            required: []
    saveLog: false
    saveResult: false

事件的 tools 字段是一个数据结构，你可以使用一个函数实现多个工具。 调用函数时，refunc 将添加两个内置参数：_call_type 和 _call_method，其中 _call_method 是工具的名称。