Refunc MCP Server

🚀 部署 Refunc MCP サーバー

Refunc MCP サーバーを使用することで、関数の作成や管理を行うことができます。以下に、Refunc MCP サーバーの部署、関数の作成、MCP エンドポイントの作成、および 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 サービスとやり取りすることができます。