MCP Gateway

1
from signalwire_agents import AgentBase
2
3
class MCPAgent(AgentBase):
4
    def __init__(self):
5
        super().__init__(name="mcp-agent")
6
        self.add_language("English", "en-US", "rime.spore")
7
8
        # Connect to MCP Gateway
9
        self.add_skill("mcp_gateway", {
10
            "gateway_url": "http://localhost:8080",
11
            "auth_user": "admin",
12
            "auth_password": "your-secure-password",
13
            "services": [
14
                {"name": "todo", "tools": "*"},      # All tools
15
                {"name": "calculator", "tools": ["add", "multiply"]}  # Specific tools
16
            ]
17
        })
18
19
        self.prompt_add_section(
20
            "Role",
21
            "You are an assistant with access to a todo list and calculator."
22
        )
23
24
if __name__ == "__main__":
25
    agent = MCPAgent()
26
    agent.run()

1
{
2
    "name": "service_name",    # Service name from gateway config
3
    "tools": "*"               # All tools, or list: ["tool1", "tool2"]
4
}

1
# Session persists across multiple tool calls in same call
2
# Call 1: "Add milk to my list" → mcp_todo_add_todo(text="milk")
3
# Call 2: "What's on my list?"  → mcp_todo_list_todos() → Returns "milk"
4
# Call 3: "Add eggs"            → mcp_todo_add_todo(text="eggs")
5
# Call 4: "Read my list"        → mcp_todo_list_todos() → Returns "milk, eggs"

1
#!/usr/bin/env python3
2
# greeter_mcp.py - Simple MCP server that the gateway can spawn
3
"""Simple MCP server example"""
4
import json
5
import sys
6
7
def handle_request(request):
8
    method = request.get("method")
9
    req_id = request.get("id")
10
11
    if method == "initialize":
12
        return {
13
            "jsonrpc": "2.0",
14
            "id": req_id,
15
            "result": {
16
                "protocolVersion": "2024-11-05",
17
                "serverInfo": {"name": "example", "version": "1.0.0"},
18
                "capabilities": {"tools": {}}
19
            }
20
        }
21
22
    elif method == "tools/list":
23
        return {
24
            "jsonrpc": "2.0",
25
            "id": req_id,
26
            "result": {
27
                "tools": [
28
                    {
29
                        "name": "greet",
30
                        "description": "Greet someone by name",
31
                        "inputSchema": {
32
                            "type": "object",
33
                            "properties": {
34
                                "name": {"type": "string", "description": "Name to greet"}
35
                            },
36
                            "required": ["name"]
37
                        }
38
                    }
39
                ]
40
            }
41
        }
42
43
    elif method == "tools/call":
44
        tool_name = request["params"]["name"]
45
        args = request["params"].get("arguments", {})
46
47
        if tool_name == "greet":
48
            name = args.get("name", "World")
49
            return {
50
                "jsonrpc": "2.0",
51
                "id": req_id,
52
                "result": {
53
                    "content": [{"type": "text", "text": f"Hello, {name}!"}]
54
                }
55
            }
56
57
    return {"jsonrpc": "2.0", "id": req_id, "error": {"code": -32601, "message": "Method not found"}}
58
59
def main():
60
    for line in sys.stdin:
61
        request = json.loads(line)
62
        response = handle_request(request)
63
        print(json.dumps(response), flush=True)
64
65
if __name__ == "__main__":
66
    main()

1
#!/usr/bin/env python3
2
# greeter_agent.py - Agent with MCP Gateway integration
3
"""Agent with MCP Gateway integration using the greeter MCP server"""
4
from signalwire_agents import AgentBase
5
6
class GreeterAgent(AgentBase):
7
    def __init__(self):
8
        super().__init__(name="greeter-agent")
9
        self.add_language("English", "en-US", "rime.spore")
10
11
        # Connect to MCP Gateway
12
        self.add_skill("mcp_gateway", {
13
            "gateway_url": "http://localhost:8080",
14
            "auth_user": "admin",
15
            "auth_password": "secure-password",
16
            "services": [
17
                {"name": "greeter", "tools": "*"}
18
            ]
19
        })
20
21
        self.prompt_add_section(
22
            "Role",
23
            "You are a friendly assistant that can greet people by name."
24
        )
25
26
        self.prompt_add_section(
27
            "Guidelines",
28
            bullets=[
29
                "When users want to greet someone, use the mcp_greeter_greet function",
30
                "Always be friendly and helpful",
31
                "The greet function requires a name parameter"
32
            ]
33
        )
34
35
if __name__ == "__main__":
36
    agent = GreeterAgent()
37
    agent.run()