内容
# Arc MCP Server
一个模型上下文协议（Model Context Protocol，MCP）服务器，简化了在各种托管环境中的框架部署，特别关注共享托管。
## 概述
Arc 在大型语言模型（Large Language Models，LLMs）与托管环境之间架起了桥梁，使初学者开发者能够通过对话接口轻松部署 web 应用程序。它实现了 [模型上下文协议（MCP）](https://modelcontextprotocol.io/)，以提供工具、资源和提示，指导用户完成部署过程。
### 主要特性
- **框架支持**：轻松部署 Wasp 应用程序，计划支持更多框架
- **多提供商支持**：支持 Netlify、Vercel、传统共享托管环境和 Hostm.com
- **引导部署**：提示用户完成部署过程
- **身份验证管理**：安全存储托管提供商凭据
- **故障排除**：内置工具用于诊断和修复常见部署问题
- **专注于共享托管**：简化传统共享托管环境的部署
## 状态
该项目目前处于早期开发阶段。欢迎贡献和反馈！
## 开始使用
### 先决条件
- Python 3.10+
- MCP Client（例如，Claude Desktop）
- 根据需要的托管提供商账户
### 安装
```bash
# 克隆仓库
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
```
### 使用
#### 从命令行运行
```bash
# 直接启动服务器
arc
# 启用调试日志
arc --debug
# 使用自定义存储路径
arc --secure-storage-path=/path/to/credentials
```
#### 与 Claude Desktop 一起使用
1. 编辑你的 Claude Desktop 配置文件：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`
2. 添加 Arc 服务器配置：
```json
{
"mcpServers": {
"arc": {
"command": "python",
"args": [
"-m",
"arc",
"--debug"
]
}
}
}
```
3. 重启 Claude Desktop。
4. 开始与 Claude 讨论部署你的应用程序！
## 架构
Arc 基于模块化架构构建：
- **凭据管理器**：安全存储和检索提供商凭据
- **框架处理程序**：特定于框架的部署逻辑
- **托管提供商**：特定于提供商的部署操作
- **MCP 接口**：通过模型上下文协议暴露工具、资源和提示
## 支持的提供商
| 提供商 | 状态 | 特性 |
|-------------|----------|--------------------------|
| Netlify | ✅ 完成 | 无服务器、边缘、表单 |
| Vercel | ✅ 完成 | 无服务器、边缘、分析 |
| 共享托管 | ✅ 完成 | SSH/SFTP、PHP、MySQL |
| Hostm.com | ✅ 完成 | 共享托管、API 访问 |
## 支持的框架
| 框架 | 状态 | 特性 |
|------------|----------|--------------------------|
| Wasp | ✅ 完成 | 全栈 JS 框架 |
| Next.js | 🚧 计划 | React 框架 |
| Astro | 🚧 计划 | 静态网站生成器 |
## 贡献
欢迎贡献！请随时提交 Pull Request。
### 开发
```bash
# 安装开发依赖
pip install -e ".[dev]"
# 运行测试
pytest
# 运行代码检查
flake8
```
## 许可证
该项目根据 MIT 许可证授权 - 详情请参见 [LICENSE](LICENSE) 文件。
## 致谢
- [模型上下文协议](https://modelcontextprotocol.io/) 使得此集成成为可能
- [Wasp](https://wasp-lang.dev/) 提供了我们初始支持中使用的优秀框架
MCP 市场