README
🚀 Arc MCP 服务器
Arc MCP 服务器是一个简化各种托管环境框架部署的 Model Context Protocol (MCP) 服务器,尤其专注于共享托管。它能有效桥接大型语言模型(LLMs)和托管环境之间的差距,让新手开发者也能通过对话式界面轻松部署网络应用程序。
🚀 快速开始
先决条件
- Python 3.10+
- MCP 客户端(例如 Claude Desktop)
- 根据需要准备各托管提供商账户
安装
# 克隆仓库
git clone https://github.com/elblanco2/arc-mcp.git
cd arc-mcp
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows 环境下使用:venv\\Scripts\\activate
# 安装依赖项
pip install -r requirements.txt
# 以开发模式安装包
pip install -e .
配置
创建一个 .env 文件,添加以下配置:
SECURE_STORAGE_PATH=~/.arc/credentials
使用方法
直接从命令行运行
# 启动服务器
arc
# 带调试日志
arc --debug
# 使用自定义存储路径
arc --secure-storage-path=/path/to/credentials
与 Claude Desktop 结合使用
- 编辑你的 Claude Desktop 配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\\Claude\\claude_desktop_config.json
- macOS:
- 添加 Arc 服务器配置:
{
"mcpServers": {
"arc": {
"command": "python",
"args": [
"-m",
"arc",
"--debug"
]
}
}
}
- 重启 Claude Desktop。
- 开始与 Claude 对话,开始部署你的应用程序!
✨ 主要特性
- 框架支持:轻松部署 Wasp 应用程序,计划增加对更多框架的支持
- 多供应商支持:支持 Netlify、Vercel、传统共享托管环境以及 Hostm.com
- 引导式部署:提示指导用户完成部署流程
- 身份验证管理:安全存储托管提供商凭证
- 故障排除工具:内置工具用于诊断和修复常见部署问题
- 专注于共享托管:简化到传统共享托管环境的部署
🔧 技术细节
架构
Arc 采用模块化架构:
- 凭证管理器:安全存储和检索提供者凭证
- 框架处理器:特定于框架的部署逻辑
- 托管提供商:特定于供应商的部署操作
- MCP 接口:通过 Model Context Protocol 暴露工具、资源和提示
支持的提供商
| 提供商 | 状态 | 功能 | |--------|------|------------| | Netlify | ✓ 完成 | 无服务器、边缘计算、表单 | | Vercel | ✓ 完成 | 无服务器、边缘计算、分析 | | 共享托管 | ✓ 完成 | SSH/SFTP、PHP、MySQL | | Hostm.com | ✓ 完成 | 共享托管、API 访问 |
支持的框架
| 框架 | 状态 | 功能 | |------|-----|------------| | Wasp | ✓ 完成 | 无服务器、边缘计算、分析 | | Next.js | 🚧 进行中 | 待定 | | Django | 🚧 进行中 | 待定 |
🤝 贡献
要进行开发,请按照以下步骤操作:
- 克隆仓库
- 安装依赖项(参见安装部分)
- 配置环境变量(如需要)
- 启动服务器并开始开发
# 运行测试
pip install -r dev-requirements.txt
pytest
# 安装开发工具
make setup
📄 许可证
该项目遵循 MIT License。
🙏 致谢
感谢以下人员和项目的贡献:
- 开发团队:@elblanco2
- 贡献者:Contributors List
通过阅读本指南,您应该能够成功安装、配置并开始使用 Arc MCP 服务器。如需进一步帮助,请参考我们的 文档页面 或加入社区讨论。
微信扫一扫