Refunc MCP Server

🚀 Deploying Refunc MCP Server

This guide provides a step-by-step process for deploying the Refunc MCP server, creating functions, setting up MCP endpoints, and understanding MCP event specifications.

🚀 Quick Start

📦 Deploying Refunc

Deploy all Refunc components to the refunc-system namespace using the following command:

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

Then, proxy the Refunc services to your local machine:

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

⚠️ Important Note

The data in this demo deployment is not persistent.

💻 Creating a Function

Use the refunc-cli to create a function. First, install the CLI:

pip install -U refunc-cli

Create a new directory and initialize the function:

mkdir mcp-demo && cd mcp-demo
rfctl init

You'll be prompted to configure the function:

Initializing function configuration file at /path/mcp-demo/lambda.yaml
Name: mcp-demo
Namespace: refunc-system
Select a language:
1 - Python
2 - Go
Please select 1 or 2 [1]:
Select a runtime:
1 - python3.10
2 - python3.9
3 - python3.8
Please select 1, 2, or 3 [1]:

Write your code in main.py. Here's a simple example that prints a greeting message. Create the function:

AWS_DEFAULT_ENDPOINT=http://127.0.0.1:8000 rfctl create

⚠️ Important Note

You need a Python 3 environment to run this function.

📚 Creating an MCP Endpoint

Edit the lambda.yaml file as follows:

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
  events:
    - name: mcp
      type: mcp
      mapping:
        args:
          token: mcp-demo
          tools:
            - name: echo-hello
              desc: Echo a hello msg # Cannot contain single quotes
              schema:
                type: object
                properties: {}
                required: []
        saveLog: false
        saveResult: false

Update the function configuration:

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

The MCP SSE endpoint URL for this example is: http://127.0.0.1:8001/refunc-system/mcp-demo/test/mcp-demo/sse

The Refunc MCP SSE URL path format is: /namespace/<token-secret-name>/<token>/<func-name>/sse

🔧 MCP Event Specification

The following is the MCP event specification:

- name: mcp
  type: mcp # The event type must be mcp.
  mapping:
    args:
      token: mcp-demo # The token secret name you can find in play-all-in-one.yaml.
      tools: # mcp tool data structure
        - name: echo-hello
          desc: Echo a hello msg # Cannot contain single quotes
          schema:
            type: object
            properties: {}
            required: []
    saveLog: false
    saveResult: false

Explanation:

• type: Specifies the event type as mcp.
• args.token: Specifies the token to use.
• args.tools: Defines a set of tools, each containing a name, description, and schema.

This configuration allows you to interact with the MCP service via HTTP requests.