x-pages-mcp

# X-Pages MCP Server X-Pages MCP Server是一个基于Model Context Protocol (MCP)的HTML部署服务，让AI能够直接部署HTML内容并获取访问URL。项目使用Python实现，基于FastMCP框架构建。 ## 🚀 功能特性 - 🤖 **AI友好** - 通过MCP协议让AI直接部署HTML内容 - 🔧 **简单易用** - 几个命令即可完成部署和管理 - 🛡️ **安全认证** - 支持token认证，保护API访问 - 🌐 **即时访问** - 部署后立即获得可访问的网站URL - 📄 **多格式支持** - 支持HTML、Markdown、TXT等格式文件部署 - 🔄 **完整管理** - 支持部署、删除、URL获取等完整操作 ## 📦 安装 ### 前置要求 - Python 3.10+ - uv (推荐) 或 pip - 已部署的X-Pages服务 ### 从PyPI安装 ```bash # 使用uvx直接运行（推荐） uvx x-pages-mcp-stdio uvx x-pages-mcp-http --port 8083 # 或使用uv安装到虚拟环境 uv add x-pages-mcp uv run x-pages-mcp-stdio # 或传统pip方式 pip install x-pages-mcp x-pages-mcp-stdio ``` ### 开发安装 ```bash # 克隆项目 git clone <repository-url> cd x-pages-mcp # 安装依赖 uv sync # 或使用pip安装 pip install -e . ``` ## ⚙️ 配置 ### 环境变量配置 所有模式都使用相同的环境变量配置： #### 方法1：使用 .env 文件（推荐） 在项目根目录创建 `.env` 文件： ```bash X_PAGES_BASE_URL=https://your-domain.com X_PAGES_API_TOKEN=your-secret-token ``` #### 方法2：直接设置环境变量 ```bash export X_PAGES_BASE_URL=https://your-domain.com export X_PAGES_API_TOKEN=your-secret-token ``` ### Claude Desktop 配置 在Claude Desktop的配置文件中添加MCP服务器： **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "x-pages-html-deployment": { "command": "uv", "args": ["run", "x-pages-mcp-stdio"], "env": { "X_PAGES_BASE_URL": "https://your-domain.com", "X_PAGES_API_TOKEN": "your-secret-token" } } } } ``` ## 🚀 使用方法 ### 传输模式 X-Pages MCP服务器支持两种传输模式： #### STDIO模式（用于Claude Desktop） 标准输入输出模式，适合Claude Desktop等本地客户端： ```bash # STDIO模式 uv run x-pages-mcp-stdio # 或使用安装后的命令 x-pages-mcp-stdio ``` #### HTTP模式（用于API集成） 基于FastAPI的HTTP API服务，支持Web客户端和API集成： ```bash # HTTP模式 uv run x-pages-mcp-http --host localhost --port 8083 # HTTP开发模式（支持自动重载） uv run x-pages-mcp-http --host localhost --port 8083 --reload # 使用安装后的命令 x-pages-mcp-http --host localhost --port 8083 ``` ### 开发测试 …