{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_f9cj3uxmxudh","handle":"mcp-deploy-2","url":"https://wellknown.network/agents/mcp-deploy-2","links":{"self":"https://wellknown.network/agents/mcp-deploy-2/record.json","html":"https://wellknown.network/agents/mcp-deploy-2","markdown":"https://wellknown.network/agents/mcp-deploy-2/record.md","api":"https://wellknown.network/api/v1/agents/mcp-deploy-2","status":"https://wellknown.network/api/v1/agents/mcp-deploy-2/status","claim":"https://wellknown.network/agents/mcp-deploy-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-deploy-2/claim.json","badge":"https://wellknown.network/agents/mcp-deploy-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-deploy-2/history","tools":"https://wellknown.network/api/v1/agents/mcp-deploy-2/tools"},"ard":{"identifier":"urn:air::server:mcp-deploy-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-deploy","summary":"MCP Deploy Server","description":"# Cloud Studio MCP 部署服务\n\n[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-green.svg)](https://fastapi.tiangolo.com/)\n\nCloud Studio MCP 部署服务是一个基于FastMCP的服务器，提供Cloud Studio工作空间的管理功能，包括创建工作空间、上传文件和执行命令等操作。\n\n## 功能特性\n\n- **创建工作空间**：创建新的Cloud Studio工作空间实例\n- **文件管理**：上传文件到指定工作空间\n- **命令执行**：在工作空间中执行shell命令\n- **MCP集成**：通过MCP协议提供标准化接口\n\n## 安装指南\n\n### 前置要求\n\n- Python 3.8+\n- API_TOKEN环境变量（Cloud Studio API访问令牌）\n\n### 安装步骤\n\n1. 克隆仓库：\n   ```bash\n   git clone <repository-url>\n   cd mcp_deploy\n   ```\n\n2. 创建并激活虚拟环境：\n   ```bash\n   python -m venv .venv\n   source .venv/bin/activate  # Linux/macOS\n   .\\.venv\\Scripts\\activate   # Windows\n   ```\n\n3. 安装依赖：\n   ```bash\n   pip install -e .\n   ```\n\n## 配置说明\n\n在运行服务前，需要设置以下环境变量：\n\n```bash\nexport API_TOKEN=\"your_cloud_studio_api_token\"\nexport region=\"ap-shanghai\"  # 可选，默认为ap-shanghai\n```\n\n## 使用说明\n\n### 启动服务\n\n```bash\npython -m mcp_deploy\n```\n\n### API 文档\n\n服务提供以下MCP工具：\n\n#### 1. 创建工作空间\n\n```python\ncreate_workspace() -> dict\n```\n返回示例：\n```json\n{\n    \"workspace_key\": \"ws-kmhhvqnlogr48\",\n    \"webIDE\": \"https://ws-kmhhv1pyvc48--ide.ap-shanghai.cloudstudio.club\"\n}\n```\n\n#### 2. 上传文件\n\n```python\nwrite_files(workspace_key: str, region: str, files: list[File]) -> str\n```\n文件格式：\n```python\nclass File:\n    save_path: str    # 文件保存路径\n    file_content: str # 文件内容(UTF-8编码)\n```\n\n#### 3. 执行命令\n\n```python\nexecute_command(workspace_key: str, region: str, command: str) -> str\n```\n示例：\n```python\nexecute_command(\"ws-xxxx\", \"ap-shanghai\", \"ls -al\")\n```\n\n## 开发指南\n\n### 项目结构\n\n```\nmcp_deploy/\n├── __init__.py\n├── __main__.py\n├── mcp_handlers.py    # 核心业务逻辑\n├── models.py          # 数据模型定义\n└── server.py          # FastMCP服务器实现\n```\n\n### 测试\n\n1. 确保已设置API_TOKEN环境变量\n2. 运行测试命令：\n   ```bash\n   python -m pytest\n   ```\n\n## 贡献\n\n欢迎提交Pull Request或Issue报告问题。\n\n## 许可证\n\n[MIT License](LICENSE)","publisher":null,"homepage":null,"repository":null,"version":"0.1.12","license":null,"protocols":["mcp"],"tags":["deploy","mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-deploy","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.814,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-deploy","registry":"pypi","observedAt":"2026-10-28T10:24:37.714Z","publishedAt":"2025-05-15T08:10:11.207187Z","latestVersion":"0.1.12"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-deploy","url":"https://pypi.org/project/mcp-deploy/","firstSeenAt":"2026-09-10T01:20:01.867Z","fetchedAt":"2026-10-28T10:24:07.356Z","normalizedAt":"2026-10-28T10:24:07.356Z"}]},"firstSeenAt":"2026-09-10T01:20:01.867Z","updatedAt":"2026-10-28T10:24:37.714Z"}