mrapids 0.1.31

Your OpenAPI, but executable
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

#!/usr/bin/env python3
"""
Example MCP client for AI agents to interact with MicroRapid

This demonstrates how an AI agent would use the MCP server to:
1. List available operations
2. Get operation details
3. Execute API calls with policy enforcement
"""

import json
import requests
from typing import Any, Dict, Optional


class MCPClient:
    """Simple MCP client for demonstration"""
    
    def __init__(self, base_url: str = "http://localhost:3333"):
        self.base_url = base_url
        self.session = requests.Session()
        self.request_id = 0
    
    def call(self, method: str, params: Optional[Dict[str, Any]] = None) -> Any:
        """Make a JSON-RPC call to the MCP server"""
        self.request_id += 1
        
        payload = {
            "jsonrpc": "2.0",
            "method": method,
            "params": params or {},
            "id": self.request_id
        }
        
        response = self.session.post(
            self.base_url,
            json=payload,
            headers={"Content-Type": "application/json"}
        )
        
        result = response.json()
        
        if "error" in result:
            raise Exception(f"MCP Error: {result['error']['message']}")
        
        return result.get("result")


def main():
    # Create MCP client
    client = MCPClient()
    
    print("MicroRapid MCP Agent Example")
    print("============================\n")
    
    # 1. Check health
    print("1. Checking server health...")
    try:
        health = client.call("health")
        print(f"   Status: {health['status']}")
        print(f"   Version: {health['version']}\n")
    except Exception as e:
        print(f"   Error: {e}\n")
        return
    
    # 2. List available operations
    print("2. Listing available operations...")
    try:
        operations = client.call("list", {
            "filter": {
                "method": "GET"
            }
        })
        print(f"   Found {operations['total']} GET operations:")
        for op in operations['operations'][:5]:  # Show first 5
            print(f"   - {op['operation_id']}: {op['method']} {op['path']}")
        if operations['total'] > 5:
            print(f"   ... and {operations['total'] - 5} more")
        print()
    except Exception as e:
        print(f"   Error: {e}\n")
    
    # 3. Get operation details
    print("3. Getting operation details for 'getUser'...")
    try:
        details = client.call("show", {
            "operation_id": "getUser"
        })
        print(f"   Operation: {details['operation_id']}")
        print(f"   Method: {details['method']}")
        print(f"   Path: {details['path']}")
        if details.get('parameters'):
            print("   Parameters:")
            for param in details['parameters']:
                print(f"   - {param['name']} ({param['location']}): {param.get('description', 'No description')}")
        print()
    except Exception as e:
        print(f"   Error: {e}\n")
    
    # 4. Execute an operation (will be controlled by policy)
    print("4. Attempting to execute 'getUser' operation...")
    try:
        result = client.call("run", {
            "operation_id": "getUser",
            "parameters": {
                "userId": "123"
            },
            "auth_profile": "default-agent"
        })
        print("   Success! Response:")
        print(f"   Status: {result.get('status')}")
        if result.get('data'):
            print(f"   Data: {json.dumps(result['data'], indent=2)}")
        print()
    except Exception as e:
        print(f"   Error: {e}")
        print("   This is expected if the operation is denied by policy\n")
    
    # 5. Try a forbidden operation (should be denied by policy)
    print("5. Attempting a DELETE operation (should be denied)...")
    try:
        result = client.call("run", {
            "operation_id": "deleteUser",
            "parameters": {
                "userId": "123"
            },
            "auth_profile": "default-agent"
        })
        print("   Unexpected success - policy may be too permissive")
    except Exception as e:
        print(f"   Expected denial: {e}")
        print("   Policy is working correctly!\n")
    
    # 6. Get available tools
    print("6. Listing available MCP tools...")
    try:
        tools = client.call("tools")
        for tool in tools:
            print(f"   - {tool['name']}: {tool['description']}")
        print()
    except Exception as e:
        print(f"   Error: {e}\n")


if __name__ == "__main__":
    main()