Metadata-Version: 2.3
Name: atomic-mcp
Version: 0.1.5
Summary: A framework for building MCP Servers using Atomic Agents and FastMCP
License: MIT
Author: jon fox
Author-email: jon@foxsolutions.dev
Requires-Python: <4.0,>=3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: atomic-agents (>=2.0.1,<3.0.0)
Requires-Dist: fastmcp (>=2.11.0,<3.0.0)
Description-Content-Type: text/markdown

# atomic-mcp

A framework for building MCP Servers using Atomic Agents and FastMCP.

Intended to be an easy to use framework for starting an MCP server and adding tools.

## Install

```bash
pip install atomic-mcp
```

## Usage

```python
from atomic_mcp import MCPServer, Tool, ToolResponse, BaseToolInput
from pydantic import Field

class HelloInput(BaseToolInput):
    name: str = Field(description="Name to greet")

class HelloTool(Tool[HelloInput]):
    name = "hello"
    description = "Say hello"
    
    async def run(self, input_data: HelloInput) -> ToolResponse:
        return ToolResponse(
            content=[{"type": "text", "text": f"Hello {input_data.name}!"}],
            is_error=False
        )

# Create server with tools
server = MCPServer("my-server")
server.register_tools([HelloTool()])

if __name__ == "__main__":
    server.run()  # STDIO for Claude Desktop
    # server.run(transport="http", port=8000, path="/mcp")  # HTTP
```

## CLI

```bash
atomic-mcp config add-stdio my-server "python" "/path/to/server.py"
```
