Metadata-Version: 2.4
Name: mcp-aichat
Version: 2026.7.1.0
Summary: MCP Server for AI Dialogue via AceDataCloud API
Project-URL: Homepage, https://github.com/AceDataCloud/AiChatMCP
Project-URL: Documentation, https://platform.acedata.cloud/documents/aichat
Project-URL: Repository, https://github.com/AceDataCloud/AiChatMCP
Project-URL: Issues, https://github.com/AceDataCloud/AiChatMCP/issues
Project-URL: Changelog, https://github.com/AceDataCloud/AiChatMCP/blob/main/CHANGELOG.md
Author-email: AceDataCloud <support@acedata.cloud>
Maintainer-email: AceDataCloud <support@acedata.cloud>
License: MIT
License-File: LICENSE
Keywords: acedata,ai-dialogue,aichat,api,chatgpt,claude,gpt,llm,mcp,model-context-protocol
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 :: Internet :: WWW/HTTP
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>=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

# MCP AiChat Server

A Model Context Protocol (MCP) server for AI dialogue via the AceDataCloud platform.
Supports a wide range of models including GPT-4/5, o-series, DeepSeek, Grok, and GLM.

## Features

- **Multi-model support**: GPT-4.1, GPT-4o, GPT-5, o1, o3, o4-mini, DeepSeek, Grok, GLM, and more
- **Multi-turn conversations**: Continue conversations using conversation IDs
- **Stateful mode**: Optional server-side conversation state management
- **Reference sources**: Include external references for context-aware responses

## Installation

```bash
pip install mcp-aichat
```

## Configuration

Set your AceDataCloud API token:

```bash
export ACEDATACLOUD_API_TOKEN=your_token_here
```

Get your token from [https://platform.acedata.cloud](https://platform.acedata.cloud).

## Usage

### stdio mode (default)

```bash
mcp-aichat
```

### HTTP mode

```bash
mcp-aichat --transport http --port 8000
```

## Available Tools

| Tool | Description |
|------|-------------|
| `aichat_create_conversation` | Create an AI conversation with any supported model |
| `aichat_create_conversation_v2` | Create/manage conversations via `/aichat2/conversations` |
| `aichat_list_models` | List all available AI models |
| `aichat_get_usage_guide` | Get API usage guide |

## Supported Models

### OpenAI
- GPT-5 series: gpt-5.5, gpt-5.4, gpt-5.2, gpt-5.1, gpt-5, gpt-5-mini, gpt-5-nano
- GPT-4.1 series: gpt-4.1, gpt-4.1-mini, gpt-4.1-nano
- GPT-4o series: gpt-4o, gpt-4o-mini, gpt-4o-all, gpt-4o-image
- GPT-4 series: gpt-4, gpt-4-turbo, gpt-4-vision-preview
- o-series: o1, o1-mini, o1-pro, o3, o3-mini, o3-pro, o4-mini

### DeepSeek
- deepseek-r1, deepseek-r1-0528, deepseek-v3, deepseek-v3-250324

### xAI
- grok-3

### Zhipu AI
- glm-5.1, glm-4.7, glm-4.6, glm-3-turbo

## License

MIT
