# oo.ai-mcp

## Introduction

This project provides a tool to search content on oo.ai.

## Usage

```python
from oo.main import search_ooai

# Search content on oo.ai
result = search_ooai("example query")
print(result)
```

## Dependencies

- fastmcp>=2.2.0
- markitdown[all]>=0.1.1
- playwright>=1.51.0
- pytest>=8.3.5

## Requirements

- Python 3.13 or higher

## Installation

1. Clone the repository:
   ```bash
   git clone https://github.com/cdecl/oo.ai-mcp
   cd oo.ai-mcp
   ```

2. Sync the dependencies:
   ```bash
   uv sync
   ```

## Running the server

To run the server directly from the cloned repository, use the following command:
```bash
uvx --from . ooai
```

Alternatively, you can run it directly from GitHub:
```bash
uvx --from git+https://github.com/cdecl/oo.ai-mcp ooai
```

## MCP Server Registration

To use this tool as an MCP server, register it in your MCP configuration with the following details:

```json
{
  "mcpServers": {
    "oo.ai-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/cdecl/oo.ai-mcp", 
        "ooai"
      ]
    }
  }
}
```

## Testing

```bash
uv run pytest -v
```