tuzi-mcp-tools


Nametuzi-mcp-tools JSON
Version 0.3.0 PyPI version JSON
download
home_pageNone
SummaryTuzi - CLI and MCP tool interfaces for Tu-zi.com API
upload_time2025-07-27 03:06:16
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseMIT
keywords ai cli image-generation mcp tuzi
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Tuzi MCP Tools

[![PyPI version](https://badge.fury.io/py/tuzi-mcp-tools.svg)](https://badge.fury.io/py/tuzi-mcp-tools)

English | [简体中文](README_zh.md)

A Python package providing both **CLI** and **MCP server** interfaces for generating images and conducting surveys using the Tu-zi.com API.

## Features

- **Dual Interface**: CLI and MCP server with clean architecture
- **Async Task Management**: Submit/barrier pattern for efficient parallel processing
- **GPT Image Generation**: GPT text to image with conversation continuity
- **FLUX Image Generation**: FLUX text to image with conversation tracking
- **Conversation Management**: Continue image editing across multiple tasks

## MCP Server Usage

```json
{
  "mcpServers": {
    "tuzi": {
      "command": "uvx",
      "args": ["tuzi-mcp-tools"],
      "env": {
        "TUZI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Available MCP Tools

The MCP server provides **async task management** with submit/barrier pattern for efficient image generation.

#### `submit_gpt_image`
Submit a GPT image generation task for async processing. Returns task ID immediately.

#### `submit_flux_image` 
Submit a FLUX image generation task for async processing. Returns task ID immediately.

#### `task_barrier`
Wait for all submitted image generation tasks to complete and download their results. Reports conversation IDs for task tracking.

## CLI Usage

```
uvx --from tuzi-mcp-tools tuzi --help
```
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "tuzi-mcp-tools",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "ai, cli, image-generation, mcp, tuzi",
    "author": null,
    "author_email": "Tuzi Tools <psycharch@github.com>",
    "download_url": "https://files.pythonhosted.org/packages/63/0c/7a8145519693437caa66bd9db85ab54fee2263382fa490c30dd47901e1f2/tuzi_mcp_tools-0.3.0.tar.gz",
    "platform": null,
    "description": "# Tuzi MCP Tools\n\n[![PyPI version](https://badge.fury.io/py/tuzi-mcp-tools.svg)](https://badge.fury.io/py/tuzi-mcp-tools)\n\nEnglish | [\u7b80\u4f53\u4e2d\u6587](README_zh.md)\n\nA Python package providing both **CLI** and **MCP server** interfaces for generating images and conducting surveys using the Tu-zi.com API.\n\n## Features\n\n- **Dual Interface**: CLI and MCP server with clean architecture\n- **Async Task Management**: Submit/barrier pattern for efficient parallel processing\n- **GPT Image Generation**: GPT text to image with conversation continuity\n- **FLUX Image Generation**: FLUX text to image with conversation tracking\n- **Conversation Management**: Continue image editing across multiple tasks\n\n## MCP Server Usage\n\n```json\n{\n  \"mcpServers\": {\n    \"tuzi\": {\n      \"command\": \"uvx\",\n      \"args\": [\"tuzi-mcp-tools\"],\n      \"env\": {\n        \"TUZI_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Available MCP Tools\n\nThe MCP server provides **async task management** with submit/barrier pattern for efficient image generation.\n\n#### `submit_gpt_image`\nSubmit a GPT image generation task for async processing. Returns task ID immediately.\n\n#### `submit_flux_image` \nSubmit a FLUX image generation task for async processing. Returns task ID immediately.\n\n#### `task_barrier`\nWait for all submitted image generation tasks to complete and download their results. Reports conversation IDs for task tracking.\n\n## CLI Usage\n\n```\nuvx --from tuzi-mcp-tools tuzi --help\n```",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Tuzi - CLI and MCP tool interfaces for Tu-zi.com API",
    "version": "0.3.0",
    "project_urls": {
        "Documentation": "https://github.com/example/tuzi-mcp-tools/blob/main/README.md",
        "Homepage": "https://github.com/example/tuzi-mcp-tools",
        "Issues": "https://github.com/example/tuzi-mcp-tools/issues",
        "Repository": "https://github.com/example/tuzi-mcp-tools"
    },
    "split_keywords": [
        "ai",
        " cli",
        " image-generation",
        " mcp",
        " tuzi"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "4cb8a744393a3b16583ae65cb1d231e38a075e75b0801d5621fb1450ac6061b9",
                "md5": "a58087d2abfe79d8bbe00dcf1024ac2c",
                "sha256": "663c91b2c0f1ea0954a3b3532a788280611ec466b13402718d1958c481527fb8"
            },
            "downloads": -1,
            "filename": "tuzi_mcp_tools-0.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a58087d2abfe79d8bbe00dcf1024ac2c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 43749,
            "upload_time": "2025-07-27T03:06:14",
            "upload_time_iso_8601": "2025-07-27T03:06:14.674757Z",
            "url": "https://files.pythonhosted.org/packages/4c/b8/a744393a3b16583ae65cb1d231e38a075e75b0801d5621fb1450ac6061b9/tuzi_mcp_tools-0.3.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "630c7a8145519693437caa66bd9db85ab54fee2263382fa490c30dd47901e1f2",
                "md5": "75df3d02e22c3a0f1e176a4fcb6f5b2b",
                "sha256": "a81e90d89673034d9bf2ac05966dc54df766d5bb183e85f259d5346439b99d76"
            },
            "downloads": -1,
            "filename": "tuzi_mcp_tools-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "75df3d02e22c3a0f1e176a4fcb6f5b2b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 33160,
            "upload_time": "2025-07-27T03:06:16",
            "upload_time_iso_8601": "2025-07-27T03:06:16.186253Z",
            "url": "https://files.pythonhosted.org/packages/63/0c/7a8145519693437caa66bd9db85ab54fee2263382fa490c30dd47901e1f2/tuzi_mcp_tools-0.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-27 03:06:16",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "example",
    "github_project": "tuzi-mcp-tools",
    "github_not_found": true,
    "lcname": "tuzi-mcp-tools"
}
        
Elapsed time: 0.76037s