http-mcp-client-server 0.1.0__tar.gz

http_mcp_client_server-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 http-mcp-client-server
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

http_mcp_client_server-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+recursive-include src/http_mcp_client *.py

http_mcp_client_server-0.1.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: http-mcp-client-server
+Version: 0.1.0
+Summary: HTTP MCP Client-Server for video enhancement API
+Project-URL: Homepage, https://github.com/yourusername/http-mcp-client-server
+Project-URL: Repository, https://github.com/yourusername/http-mcp-client-server
+Project-URL: Issues, https://github.com/yourusername/http-mcp-client-server/issues
+Author-email: Your Name <your.email@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: client,enhancement,fastapi,http,mcp,server,video
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# http-mcp-client-server (Python)
+
+[![PyPI version](https://badge.fury.io/py/http-mcp-client-server.svg)](https://pypi.org/project/http-mcp-client-server/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+基于 MCP 协议的视频增强服务，作为 MCP Client-Server 与 FastAPI HTTP Server 交互。
+
+## 功能
+
+提供以下 MCP Tools：
+- `create_task` - 创建视频增强任务（支持 URL 或本地文件上传）
+- `get_task_status` - 查询任务状态
+- `enhance_video_sync` - 同步增强视频（阻塞等待）
+
+## 安装
+
+### 从 PyPI 安装（推荐）
+
+```bash
+# 使用 pip 安装
+pip install http-mcp-client-server
+
+# 或使用 uv 安装
+uv pip install http-mcp-client-server
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/yourusername/http-mcp-client-server.git
+cd python_client
+
+# 使用 uv 安装（推荐）
+uv pip install -e ".[dev]"
+
+# 或使用 pip 安装
+pip install -e ".[dev]"
+```
+
+## 使用方法
+
+### 1. 命令行启动
+
+```bash
+# 直接运行（安装后）
+http-mcp-client-server --base-url http://localhost:8000 --api-key your-api-key
+
+# 或使用环境变量
+export HTTP_API_BASE_URL=http://localhost:8000
+export HTTP_API_KEY=your-api-key
+http-mcp-client-server
+```
+
+### 2. 在 Claude Desktop 中配置
+
+编辑 Claude Desktop 配置文件：
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "video-enhancement": {
+      "command": "http-mcp-client-server",
+      "args": [
+        "--base-url",
+        "http://localhost:8000",
+        "--api-key",
+        "your-api-key"
+      ]
+    }
+  }
+}
+```
+
+### 3. 使用 uv run 运行（开发模式）
+
+```bash
+uv run http-mcp-client-server --base-url http://localhost:8000 --api-key your-api-key
+```
+
+## 提供的 Tools
+
+### create_task
+
+创建视频增强任务（异步）。
+
+**参数：**
+- `video_source` (string, required): 视频 URL 或本地文件路径
+- `type` (string, optional): 上传类型，默认 "url"
+  - 可选值: `"url"` - 网络视频URL, `"local"` - 本地文件路径
+- `resolution` (string, optional): 目标分辨率，默认 720p
+  - 可选值: 480p, 540p, 720p, 1080p, 2k
+
+**使用示例：**
+
+```python
+# URL 方式
+{
+  "video_source": "https://example.com/video.mp4",
+  "type": "url",
+  "resolution": "1080p"
+}
+
+# 本地文件方式
+{
+  "video_source": "/path/to/local/video.mp4",
+  "type": "local",
+  "resolution": "1080p"
+}
+```
+
+**返回值：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "wait"
+}
+```
+
+### get_task_status
+
+查询任务状态。
+
+**参数：**
+- `task_id` (string, required): 任务ID
+
+**使用示例：**
+```python
+{
+  "task_id": "task-123-abc"
+}
+```
+
+**返回值：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "completed",
+  "progress": 100,
+  "video_url": "https://...",
+  "error_message": null,
+  "created_at": "2024-01-01T00:00:00Z",
+  "updated_at": "2024-01-01T00:01:00Z"
+}
+```
+
+### enhance_video_sync
+
+同步增强视频（阻塞等待完成）。
+
+**参数：**
+- `video_source` (string, required): 视频 URL 或本地文件路径
+- `type` (string, optional): 上传类型，默认 "url"
+  - 可选值: `"url"` - 网络视频URL, `"local"` - 本地文件路径
+- `resolution` (string, optional): 目标分辨率，默认 720p
+- `poll_interval` (number, optional): 轮询间隔（秒），默认 5
+- `timeout` (number, optional): 超时时间（秒），默认 600
+
+**使用示例：**
+```python
+{
+  "video_source": "https://example.com/video.mp4",
+  "type": "url",
+  "resolution": "1080p",
+  "poll_interval": 5,
+  "timeout": 600
+}
+```
+
+**返回值：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "completed",
+  "progress": 100,
+  "video_url": "https://..."
+}
+```
+
+## 文件上传说明
+
+当 `type` 设置为 `"local"` 时，MCP Server 会：
+1. 读取本地文件
+2. 将文件转为 base64 编码
+3. 上传到视频增强服务
+
+**限制：**
+- 最大文件大小：100MB
+
+## 环境变量
+
+| 变量名 | 说明 | 默认值 |
+|--------|------|--------|
+| `HTTP_API_BASE_URL` | FastAPI HTTP Server 地址 | `http://localhost:8000` |
+| `HTTP_API_KEY` | API 认证密钥 | 无 |
+
+## 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/yourusername/http-mcp-client-server.git
+cd python_client
+
+# 安装开发依赖
+uv pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 代码格式化
+ruff format .
+ruff check --fix .
+```
+
+## 发布到 PyPI
+
+```bash
+# 安装构建工具
+uv pip install build twine
+
+# 构建分发包
+python -m build
+
+# 上传到 PyPI（测试）
+python -m twine upload --repository testpypi dist/*
+
+# 上传到 PyPI（正式）
+python -m twine upload dist/*
+```
+
+## License
+
+MIT License - 详见 [LICENSE](LICENSE) 文件

http_mcp_client_server-0.1.0/PUBLISH.md

@@ -0,0 +1,235 @@
+# 发布到 PyPI 指南
+
+## 前置准备
+
+1. **注册 PyPI 账号**
+   - 访问 https://pypi.org/account/register/
+   - 注册并验证邮箱
+   - 开启双因素认证 (2FA)
+   - 创建 API Token（在 Account Settings → API tokens）
+
+2. **准备 API Token**
+
+   在 PyPI 账号设置中创建 API Token，发布时需要用到。
+
+   每次上传时会提示输入：
+   - Username: `__token__`
+   - Password: 你的 API Token (格式: `pypi-xxxxxxxxxxxx`)
+
+## 发布步骤
+
+### 1. 确保代码准备就绪
+
+```bash
+# 运行测试
+pytest
+
+# 代码格式化
+ruff format .
+ruff check --fix .
+
+# 验证包可以正常构建
+python -m build
+```
+
+### 2. 更新版本号
+
+修改以下文件中的版本号：
+- `pyproject.toml` - `version = "x.x.x"`
+- `src/http_mcp_client/__init__.py` - `__version__ = "x.x.x"`
+
+### 3. 构建分发包
+
+**PowerShell:**
+```powershell
+# 清理旧的构建文件
+Remove-Item -Recurse -Force dist/, build/ -ErrorAction SilentlyContinue
+Remove-Item *.egg-info -Recurse -Force -ErrorAction SilentlyContinue
+
+# 构建 wheel 和 sdist
+python -m build
+
+# 检查构建结果
+Get-ChildItem dist/
+# 应该包含：
+# - http_mcp_client_server-X.X.X-py3-none-any.whl
+# - http-mcp-client-server-X.X.X.tar.gz
+```
+
+**CMD / macOS / Linux:**
+```bash
+# 清理旧的构建文件
+rm -rf dist/ build/ *.egg-info
+
+# 构建 wheel 和 sdist
+python -m build
+
+# 检查构建结果
+ls -la dist/
+# 应该包含：
+# - http_mcp_client_server-X.X.X-py3-none-any.whl
+# - http-mcp-client-server-X.X.X.tar.gz
+```
+
+### 4. 验证包
+
+```bash
+# 使用 twine 检查
+python -m twine check dist/*
+
+# 测试安装
+pip install dist/http_mcp_client_server-X.X.X-py3-none-any.whl
+```
+
+### 5. 上传到 TestPyPI（可选但推荐）
+
+```bash
+# 运行上传命令，会提示输入用户名和密码
+python -m twine upload --repository testpypi dist/*
+
+# 交互式输入：
+# Username: __token__
+# Password: pypi-xxxxx (你的 TestPyPI API Token)
+```
+
+测试安装：
+```bash
+pip install --index-url https://test.pypi.org/simple/ http-mcp-client-server
+```
+
+### 6. 上传到正式 PyPI
+
+#### 方式一：交互式输入（推荐，安全）
+
+**PowerShell:**
+```powershell
+cd python_client
+python -m twine upload dist/*
+# 然后按提示输入：
+# Username: __token__
+# Password: pypi-AgEIcHlwaS5vcmcCJD...
+```
+
+**CMD:**
+```cmd
+cd python_client
+python -m twine upload dist/*
+REM 然后按提示输入用户名和密码
+```
+
+**macOS/Linux:**
+```bash
+cd python_client
+python -m twine upload dist/*
+# 然后按提示输入用户名和密码
+```
+
+#### 方式二：环境变量方式（不保存到文件）
+
+**PowerShell:**
+```powershell
+# 设置环境变量（仅当前会话有效）
+$env:TWINE_USERNAME = "__token__"
+$env:TWINE_PASSWORD = "pypi-AgEIcHlwaS5vcmcCJD..."
+
+# 执行上传（不需要输入用户名密码）
+python -m twine upload dist/*
+
+# 上传完成后清除环境变量（可选，关闭窗口自动清除）
+Remove-Item Env:\TWINE_USERNAME
+Remove-Item Env:\TWINE_PASSWORD
+```
+
+**CMD:**
+```cmd
+set TWINE_USERNAME=__token__
+set TWINE_PASSWORD=pypi-xxxxx
+python -m twine upload dist/*
+```
+
+**macOS/Linux:**
+```bash
+export TWINE_USERNAME=__token__
+export TWINE_PASSWORD=pypi-xxxxx
+python -m twine upload dist/*
+```
+
+### 7. 验证发布
+
+```bash
+# 等待几分钟让 PyPI 索引更新
+pip install http-mcp-client-server
+
+# 验证安装
+http-mcp-client-server --help
+```
+
+### 8. 创建 Git 标签（可选）
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+## 故障排除
+
+### 上传失败：文件已存在
+
+PyPI 不允许重复上传相同版本。需要：
+1. 更新版本号
+2. 重新构建
+3. 重新上传
+
+### 构建失败
+
+确保安装了 build 工具：
+```bash
+uv pip install build
+```
+
+### 验证失败
+
+运行 `twine check` 查看具体错误：
+```bash
+python -m twine check dist/*
+```
+
+常见问题：
+- README.md 格式错误
+- 缺少必需的元数据
+- 版本号格式不正确
+
+## 自动化发布（GitHub Actions）
+
+可以创建 `.github/workflows/publish.yml` 实现自动发布：
+
+```yaml
+name: Publish to PyPI
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        python -m build
+        twine upload dist/*
+```
+
+然后在 GitHub 仓库设置中添加 `PYPI_API_TOKEN` secret。