Shellfusion MCP Server

ShellFusion MCP服务器

一个全栈应用程序，具有Node.js/Express后端、React前端和用于AI助手集成的Python MCP服务器。

MCP服务器快速启动

该项目包括 基于Python的MCP（模型上下文协议）服务器 在 mcp/ 该目录允许Claude Desktop和ChatGPT等AI助手与ShellFusion后端进行交互。

可用工具

• 健康检查 -检查后端运行状况
• list_items -列出后端的所有项目
• 创建项目 -创建新项目

设置和运行

1. 安装依赖项:

cd mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

1. 运行服务器 （与检验员一起测试）：

mcp dev server.py

1. 为Claude桌面配置:

增添 ~/.config/Claude/claude_desktop_config.json （Linux）或 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "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.克隆和安装依赖项

# 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.启动数据库

# Start MongoDB with Docker Compose
cd docker
docker-compose up -d

3.启动开发服务器

# 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（根/示例）

为生产而建

# Build backend
cd backend
npm run build
npm start

# Build frontend
cd frontend
npm run build
npm run preview

附加命令

# Lint code
npm run lint

# Format code
npm run format