🧠 Test_aaa MCP Server

This module implements the MCP protocol bindings for the Test_aaa agent.

It auto-generates MCP compliant tools or data models and server code.

The server acts as a wrapper over the agent's async call loop and translates standard input/output formats.

---

📄 Overview

• Description: MCP server generated from OpenAPI by Backstage
• Version: 0.1.0
• Author: Platform Engineering

---

📁 Module Structure

mcp_test_aaa/
├── __init__.py
├── server.py
├── api/
│   ├── __init__.py
│   └── client.py
├── models/
│   ├── __init__.py
│   └── base.py
└── tools/
    ├── __init__.py
    ├── pet_findbystatus.py
    ├── pet_findbytags.py
    ├── pet_petid_uploadimage.py
    ├── pet_petid.py
    ├── pet.py
    ├── store_inventory.py
    ├── store_order_orderid.py
    ├── store_order.py
    ├── user_createwitharray.py
    ├── user_createwithlist.py
    ├── user_login.py
    ├── user_logout.py
    ├── user_username.py
    └── user.py

---

🚀 Running the MCP Server

Make sure dependencies are installed and environment variables are configured. Then run:

poetry run mcp_test_aaa

Or directly with Python:

uv run python -m mcp_test_aaa.server

---

🌐 API Endpoints

• MCP /mcp — Streamable HTTP endpoint for MCP clients

You can test with:

curl -i http://localhost:8000/mcp

---

⚙️ Environment Variables

Variable	Description
TEST_AAA_API_URL	Base URL of the upstream API
TEST_AAA_TOKEN	Token used to authenticate against the API
MCP_MODE	Transport mode (stdio, http)
MCP_HOST	Host to bind the MCP server
MCP_PORT	Port to run the MCP server (default: 8000)

---

🧰 Available Tools

The following tools are exposed by this agent via the MCP protocol. These are defined in the tools/ directory and registered at runtime.

• pet_petid_uploadimage.post_upload_file
• pet.post_add_pet
• pet.put_upd_pet
• pet_findbystatus.get_find_pets_status
• pet_findbytags.get_find_pets_tags
• pet_petid.get_pet_id
• pet_petid.post_upd_pet_form
• pet_petid.del_pet
• store_inventory.get_inventory
• store_order.post_place_order
• store_order_orderid.get_order_id
• store_order_orderid.del_order
• user_createwithlist.post_new_users_ls_input
• user_username.get_user_name
• user_username.put_upd_user
• user_username.del_user
• user_login.get_login_user
• user_logout.get_logout_user
• user_createwitharray.post_new_users_array_input
• user.post_new_user

---

🧪 Testing

To test locally:

uv run python -m mcp_test_aaa.server

Or with the MCP Inspector:

npx @modelcontextprotocol/inspector uv run python -m mcp_test_aaa.server

---

📚 References

• OpenAPI MCP Codegen