ShellFusion MCP服务器
一个全栈应用程序,具有Node.js/Express后端、React前端和用于AI助手集成的Python MCP服务器。
MCP服务器快速启动
该项目包括 基于Python的MCP(模型上下文协议)服务器 在 mcp/ 该目录允许Claude Desktop和ChatGPT等AI助手与ShellFusion后端进行交互。
可用工具
- 健康检查 -检查后端运行状况
- list_items -列出后端的所有项目
- 创建项目 -创建新项目
设置和运行
- 安装依赖项:```bash
cd mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
2. **运行服务器** (与检验员一起测试):```bash
mcp dev server.py
- 为Claude桌面配置:
增添 ~/.config/Claude/claude_desktop_config.json (Linux)或 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):```json
{
"mcpServers": {
"shellfusion": {
"command": "/absolute/path/to/ShellFusion-mcp-server/mcp/.venv/bin/python",
"args": ["server.py"],
"env": {
"BACKEND_BASE_URL": "http://localhost:4000"
}
}
}
}
替换 `/absolute/path/to/ShellFusion-mcp-server/mcp/` 你的实际路径。然后重新启动Claude Desktop。
**备注**:在使用MCP服务器之前,请确保您的后端在端口4000上运行。
______________________________________________________________________
## 先决条件
- **Node.js** (v18或更高版本)
- **npm** 或 **纱线**
- **码头工人** 和 **Docker Compose**
- **python** (3.10或更高版本)-适用于MCP服务器
## 地方发展设置
### 1.克隆和安装依赖项```bash
# Install backend dependencies
cd backend
npm install
# Install frontend dependencies
cd ../frontend
npm install
npm install @reduxjs/toolkit react-redux react-router-dom react-hook-form @hookform/resolvers joi axios jwt-decode
2.启动数据库```bash
Start MongoDB with Docker Compose
cd docker
docker-compose up -d
### 3.启动开发服务器```bash
# Terminal 1 - Backend (runs on port 3000 by default)
cd backend
npm run dev
# Terminal 2 - Frontend (runs on port 5173 by default)
cd frontend
npm run dev
4.访问申请
- 前端: http://localhost:5173
- 后端API: http://localhost:3000
- MongoDB:本地主机:27017(根/示例)
为生产而建```bash
Build backend
cd backend
npm run build
npm start
Build frontend
cd frontend
npm run build
npm run preview
## 附加命令```bash
# Lint code
npm run lint
# Format code
npm run format
