MCP远程开发服务器
支持在另一台Mac上进行远程开发的MCP（模型上下文协议）服务器。创建文件，开发Spring Boot API，并从本地开发环境管理远程计算机上的项目。
特性
- 基于SSH的远程访问：通过SSH安全连接到另一台Mac
- 文件管理：远程创建、读取、编辑和管理文件
- Spring Boot开发：生成具有自定义依赖项的完整Spring Boot项目
- 应用程序管理：远程运行、停止和构建Spring Boot应用程序
- 项目生成：自动创建Spring Boot项目结构
先决条件
在本地Mac上（您将在其中运行MCP客户端）
- Node.js 18+
- npm或纱线
- MCP兼容客户端（如Claude Desktop）
在您的远程Mac上（开发发生的地方）
- macOS
- SSH服务器已启用(
System Settings > General > Sharing > Remote Login) - Java 17+（用于Spring Boot开发）
- Maven 3.6+（适用于Spring Boot版本）
- SSH密钥或密码身份验证
安装
- 克隆和安装依赖关系：
git clone
cd mcp-work-support
npm install- 构建项目：
npm run build配置
1.在远程Mac上启用SSH
在您的远程Mac上：
- 首选
System Settings > General > Sharing - 启用
Remote Login - 记下您的用户名（通常是macOS用户名）
2.设置SSH身份验证
选择以下方法之一：
选项A:SSH密钥（推荐）
# Generate SSH key pair (on local Mac)
ssh-keygen -t rsa -b 4096 -C "your-email@example.com"
# Copy public key to remote Mac
ssh-copy-id username@remote-mac-ip选项B：密码验证
- 确保您拥有远程Mac用户的密码
3.配置MCP服务器
使用 configure_remote_connection MCP客户端中用于设置连接的工具：
{
"host": "192.168.1.100",
"username": "your-username",
"password": "your-password", // OR use privateKeyPath
"privateKeyPath": "/path/to/private/key", // OR use password
"port": 22
}用法
MCP客户端配置
将服务器添加到MCP客户端配置中（例如，Claude Desktop）：
{
"mcpServers": {
"remote-dev": {
"command": "node",
"args": ["/path/to/mcp-work-support/dist/index.js"]
}
}
}可用工具
连接管理
configure_remote_connection：设置SSH连接详细信息test_connection：测试与远程Mac的SSH连接
文件操作
create_file：在远程Mac上创建新文件read_file：从远程Mac读取文件内容list_directory：列出目录内容create_directory：在远程Mac上创建目录
Spring Boot开发
create_spring_boot_project：生成一个完整的Spring Boot项目run_spring_boot_app：启动Spring Boot应用程序stop_spring_boot_app：停止正在运行的Spring Boot应用程序build_spring_boot_app：构建Spring Boot应用程序
示例用法
1.配置连接
{
"host": "192.168.1.100",
"username": "developer",
"privateKeyPath": "/Users/you/.ssh/id_rsa"
}2.测试连接
使用 test_connection 用于验证SSH访问的工具。
3.创建Spring Boot项目
{
"name": "MyApi",
"groupId": "com.example",
"description": "My REST API",
"dependencies": ["web", "data-jpa", "h2", "validation"],
"basePath": "~/projects"
}4.运行应用程序
{
"projectPath": "~/projects/MyApi",
"port": 8080
}该应用程序可在以下网址访问 http://remote-mac-ip:8080
5.创建自定义文件
{
"path": "~/projects/MyApi/src/main/java/com/example/MyApiApplication.java",
"content": "// Your custom Java code here"
}项目结构
创建后，您的Spring Boot项目将具有：
MyApi/
├── pom.xml
├── src/
│ ├── main/
│ │ ├── java/com/example/
│ │ │ ├── MyApiApplication.java
│ │ │ └── HelloController.java
│ │ └── resources/
│ │ └── application.properties
│ └── test/
│ └── java/
└── target/ (after build)故障排除
SSH连接问题
- “连接被拒绝”：确保在远程Mac上启用了远程登录
- “权限被拒绝”：检查SSH密钥权限或密码
- “主机密钥验证失败”：将远程主机添加到known_hosts或使用
-o StrictHostKeyChecking=no
Java/Maven问题
- “找不到java命令”：在远程Mac上安装Java 17+
- “找不到mvn命令”：在远程Mac上安装Maven
- 端口已在使用中：更改application.properties中的端口或停止其他服务
构建问题
- 检查应用程序日志：
tail -f ~/projects/MyProject/app.log - 验证pom.xml中的依赖关系
- 确保Java版本兼容性
安全说明
- 尽可能使用SSH密钥而不是密码
- 将SSH访问限制为特定用户
- 在远程Mac上保持Java和依赖项的更新
- 监控远程Mac上正在运行的进程
发展
要贡献或修改MCP服务器：
# Development mode
npm run dev
# Build for production
npm run build
# Run tests
npm test许可证
MIT许可证-有关详细信息，请参阅许可证文件。