# 🧠 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:

```bash
poetry run mcp_test_aaa
```

Or directly with Python:

```bash
uv run python -m mcp_test_aaa.server
```

---

## 🌐 API Endpoints

- `MCP /mcp` — Streamable HTTP endpoint for MCP clients

You can test with:

```bash
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:

```bash
uv run python -m mcp_test_aaa.server
```

Or with the MCP Inspector:

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

---

## 📚 References

- [OpenAPI MCP Codegen](https://github.com/cnoe-io/openapi-mcp-codegen)