Metadata-Version: 2.4
Name: mcp-openai-pro
Version: 2026.10.4.1
Summary: MCP Server for OpenAI API via AceDataCloud
Project-URL: Homepage, https://github.com/AceDataCloud/OpenAIMCP
Project-URL: Documentation, https://platform.acedata.cloud/documents/openai?utm_source=pypi&utm_medium=referral&utm_campaign=evergreen&utm_content=openai_mcp_package_quick_start
Project-URL: Repository, https://github.com/AceDataCloud/OpenAIMCP
Project-URL: Issues, https://github.com/AceDataCloud/OpenAIMCP/issues
Project-URL: Changelog, https://github.com/AceDataCloud/OpenAIMCP/blob/main/CHANGELOG.md
Author-email: AceDataCloud <support@acedata.cloud>
Maintainer-email: AceDataCloud <support@acedata.cloud>
License: MIT
License-File: LICENSE
Keywords: acedata,api,chatgpt,claude,dall-e,embeddings,gpt,llm,mcp,model-context-protocol,openai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: loguru>=0.7.0
Requires-Dist: mcp<2,>=1.2.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: all
Requires-Dist: build>=1.2.0; extra == 'all'
Requires-Dist: mypy>=1.10.0; extra == 'all'
Requires-Dist: pre-commit>=3.7.0; extra == 'all'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'all'
Requires-Dist: pytest-cov>=5.0.0; extra == 'all'
Requires-Dist: pytest>=8.0.0; extra == 'all'
Requires-Dist: respx>=0.21.0; extra == 'all'
Requires-Dist: ruff>=0.4.0; extra == 'all'
Requires-Dist: twine>=5.0.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Provides-Extra: release
Requires-Dist: build>=1.2.0; extra == 'release'
Requires-Dist: twine>=5.0.0; extra == 'release'
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Requires-Dist: respx>=0.21.0; extra == 'test'
Description-Content-Type: text/markdown

<!-- Generated by scripts/marketing_readmes.py from README.md; do not edit. -->
# OpenAIMCP

<!-- mcp-name: io.github.AceDataCloud/mcp-openai -->

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for OpenAI API access using [AceDataCloud](https://platform.acedata.cloud?utm_source=pypi&utm_medium=referral&utm_campaign=evergreen&utm_content=openai_mcp_package_platform).

Interact with OpenAI models for chat completions, image generation, text embeddings, and more — directly from Claude, VS Code, or any MCP-compatible client.

The AceDataCloud distribution is `mcp-openai-pro`. The unrelated
`mcp-openai` package on PyPI is not maintained by AceDataCloud. Update existing
`uvx` configurations to the new package name; the hosted MCP URL is unchanged.

## Features

- **Chat Completions** — Access GPT-4, GPT-4o, GPT-5, o1, o3, o4-mini, and many more models
- **Responses API** — Extended model variant support including dated releases and search-preview models
- **Image Generation** — Create images with gpt-image-1, gpt-image-2, GPT Image 2.5 Flare/Sunburst standard or official variants, dall-e-3, and nano-banana models
- **Image Editing** — Modify existing images with AI
- **Text Embeddings** — Generate vector representations with text-embedding-3 models
- **Audio** — Convert text to speech and transcribe audio with whisper-1 or gpt-transcribe

## Quick Start

### Prerequisites

Get an API token from [AceDataCloud](https://platform.acedata.cloud?utm_source=pypi&utm_medium=referral&utm_campaign=evergreen&utm_content=openai_mcp_package_platform).

### Installation

```bash
pip install mcp-openai-pro
```

### Configuration

Set your API token:

```bash
export ACEDATACLOUD_API_TOKEN=your_api_token_here
```

### Run

```bash
mcp-openai-pro
```

## Available Tools

| Tool | Description |
|------|-------------|
| `openai_chat_completion` | Create chat completions using OpenAI models |
| `openai_create_response` | Create responses using the Responses API |
| `openai_generate_image` | Generate images from text descriptions |
| `openai_edit_image` | Edit existing images with AI |
| `openai_create_embedding` | Create text embedding vectors |
| `openai_text_to_speech` | Convert text to spoken audio |
| `openai_transcribe_audio` | Transcribe audio from a URL |
| `openai_list_chat_models` | List available chat/completion models |
| `openai_list_image_models` | List available image models |
| `openai_list_embedding_models` | List available embedding models |
| `openai_get_usage_guide` | Get comprehensive usage guide |

## Supported Models

### Chat Completion Models
- **GPT-5 Series**: gpt-5.5, gpt-5.5-pro, gpt-5.4, gpt-5.4-pro, gpt-5.2, gpt-5.1, gpt-5, gpt-5-mini, gpt-5-nano
- **GPT-4 Series**: gpt-4.1, gpt-4.1-mini, gpt-4.1-nano, gpt-4o, gpt-4o-mini, gpt-4
- **Reasoning**: o4-mini, o3, o3-mini, o3-pro, o1, o1-mini, o1-pro

### Image Models
- gpt-image-1, gpt-image-1.5, gpt-image-2, gpt-image-2:official, gpt-image-2.5-flare, gpt-image-2.5-flare:official, gpt-image-2.5-sunburst, gpt-image-2.5-sunburst:official, dall-e-3, dall-e-2, nano-banana, nano-banana-2, nano-banana-pro
- GPT Image `:official` variants settle from actual text-input, image-input, and image-output tokens.

### Embedding Models
- text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002

### Audio Transcription Models
- whisper-1, gpt-transcribe

## Usage Examples

### Chat Completion

```
openai_chat_completion(
    messages=[{"role": "user", "content": "Explain quantum computing in simple terms"}],
    model="gpt-4.1"
)
```

### Image Generation

```
openai_generate_image(
    prompt="A serene Japanese garden with cherry blossoms at sunset, photorealistic",
    model="gpt-image-1",
    size="1024x1024"
)
```

### Text Embeddings

```
openai_create_embedding(
    input="The quick brown fox jumps over the lazy dog",
    model="text-embedding-3-small"
)
```

## Configuration

| Variable | Description | Default |
|----------|-------------|---------|
| `ACEDATACLOUD_API_TOKEN` | API token (required) | — |
| `ACEDATACLOUD_API_BASE_URL` | API base URL | `https://api.acedata.cloud` |
| `OPENAI_REQUEST_TIMEOUT` | Request timeout in seconds | `60` |
| `MCP_SERVER_NAME` | MCP server name | `openai` |
| `LOG_LEVEL` | Logging level | `INFO` |

## Development

```bash
# Install dependencies
pip install -e ".[dev,test]"

# Run tests
pytest

# Run linter
ruff check .
```

## API Reference

- [AceDataCloud Platform](https://platform.acedata.cloud?utm_source=pypi&utm_medium=referral&utm_campaign=evergreen&utm_content=openai_mcp_package_platform)
- [OpenAI API Documentation](https://platform.openai.com/docs)

## Documentation

<!-- canonical-documentation -->
[Documentation](https://platform.acedata.cloud/documents/openai?utm_source=pypi&utm_medium=referral&utm_campaign=evergreen&utm_content=openai_mcp_package_quick_start)

## License

MIT
