{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ptfcvmkbt7c8","handle":"x-pages-mcp","url":"https://wellknown.network/agents/x-pages-mcp","links":{"self":"https://wellknown.network/agents/x-pages-mcp/record.json","html":"https://wellknown.network/agents/x-pages-mcp","markdown":"https://wellknown.network/agents/x-pages-mcp/record.md","api":"https://wellknown.network/api/v1/agents/x-pages-mcp","status":"https://wellknown.network/api/v1/agents/x-pages-mcp/status","claim":"https://wellknown.network/agents/x-pages-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/x-pages-mcp/claim.json","badge":"https://wellknown.network/agents/x-pages-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:x-pages-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"x-pages-mcp","summary":"MCP server for X-Pages HTML deployment service","description":"# X-Pages MCP Server\n\nX-Pages MCP Server是一个基于Model Context Protocol (MCP)的HTML部署服务，让AI能够直接部署HTML内容并获取访问URL。项目使用Python实现，基于FastMCP框架构建。\n\n## 🚀 功能特性\n\n- 🤖 **AI友好** - 通过MCP协议让AI直接部署HTML内容\n- 🔧 **简单易用** - 几个命令即可完成部署和管理\n- 🛡️ **安全认证** - 支持token认证，保护API访问\n- 🌐 **即时访问** - 部署后立即获得可访问的网站URL\n- 📄 **多格式支持** - 支持HTML、Markdown、TXT等格式文件部署\n- 🔄 **完整管理** - 支持部署、删除、URL获取等完整操作\n\n## 📦 安装\n\n### 前置要求\n\n- Python 3.10+\n- uv (推荐) 或 pip\n- 已部署的X-Pages服务\n\n### 从PyPI安装\n\n```bash\n# 使用uvx直接运行（推荐）\nuvx x-pages-mcp-stdio\nuvx x-pages-mcp-http --port 8083\n\n# 或使用uv安装到虚拟环境\nuv add x-pages-mcp\nuv run x-pages-mcp-stdio\n\n# 或传统pip方式\npip install x-pages-mcp\nx-pages-mcp-stdio\n```\n\n### 开发安装\n\n```bash\n# 克隆项目\ngit clone <repository-url>\ncd x-pages-mcp\n\n# 安装依赖\nuv sync\n\n# 或使用pip安装\npip install -e .\n```\n\n## ⚙️ 配置\n\n### 环境变量配置\n\n所有模式都使用相同的环境变量配置：\n\n#### 方法1：使用 .env 文件（推荐）\n\n在项目根目录创建 `.env` 文件：\n\n```bash\nX_PAGES_BASE_URL=https://your-domain.com\nX_PAGES_API_TOKEN=your-secret-token\n```\n\n#### 方法2：直接设置环境变量\n\n```bash\nexport X_PAGES_BASE_URL=https://your-domain.com\nexport X_PAGES_API_TOKEN=your-secret-token\n```\n\n### Claude Desktop 配置\n\n在Claude Desktop的配置文件中添加MCP服务器：\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"x-pages-html-deployment\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"x-pages-mcp-stdio\"],\n      \"env\": {\n        \"X_PAGES_BASE_URL\": \"https://your-domain.com\",\n        \"X_PAGES_API_TOKEN\": \"your-secret-token\"\n      }\n    }\n  }\n}\n```\n\n## 🚀 使用方法\n\n### 传输模式\n\nX-Pages MCP服务器支持两种传输模式：\n\n#### STDIO模式（用于Claude Desktop）\n\n标准输入输出模式，适合Claude Desktop等本地客户端：\n\n```bash\n# STDIO模式\nuv run x-pages-mcp-stdio\n\n# 或使用安装后的命令\nx-pages-mcp-stdio\n```\n\n#### HTTP模式（用于API集成）\n\n基于FastAPI的HTTP API服务，支持Web客户端和API集成：\n\n```bash\n# HTTP模式\nuv run x-pages-mcp-http --host localhost --port 8083\n\n# HTTP开发模式（支持自动重载）\nuv run x-pages-mcp-http --host localhost --port 8083 --reload\n\n# 使用安装后的命令\nx-pages-mcp-http --host localhost --port 8083\n```\n\n### 开发测试\n…","publisher":{"name":"X-Pages Team","url":null},"homepage":"https://github.com/xingshulin/x-pages-mcp/blob/main/README.md","repository":"https://github.com/xingshulin/x-pages-mcp/issues","version":"0.1.4","license":"MIT License\n        \n        Copyright (c) 2024 X-Pages Team\n  …","protocols":["mcp"],"tags":["ai","claude","deployment","html","mcp","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:x-pages-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.791,"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":"x-pages-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:22.022Z","publishedAt":"2025-08-21T10:20:34.018648Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"x-pages-mcp","url":"https://pypi.org/project/x-pages-mcp/","firstSeenAt":"2026-09-10T16:23:01.796Z","fetchedAt":"2026-09-10T16:23:01.796Z","normalizedAt":"2026-09-10T16:23:01.796Z"}]},"firstSeenAt":"2026-09-10T16:23:01.796Z","updatedAt":"2026-09-10T16:24:22.022Z"}