手把手教你部署Dify+MCP：从零搭建企业级智能体应用的终极指南

bash

# Windows系统需执行（管理员权限）：
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart
wsl --install -d Ubuntu

# Linux系统安装Docker：
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
systemctl enable docker && systemctl start docker

# 验证安装（所有系统适用）：
docker run hello-world | grep -q "Hello from Docker!" && echo "安装成功"

bash

git clone -b v0.15.3 https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env  # 关键配置修改：
sed -i 's/CUSTOM_MODEL_ENABLED=false/CUSTOM_MODEL_ENABLED=true/g' .env
sed -i 's/WEAVIATE_HOST=weaviate/WEAVIATE_HOST=host.docker.internal/g' .env

bash

# 首次启动（建议科学上网）：
docker-compose up -d --build

# 查看实时日志：
docker-compose logs -f --tail=100 api

# 常见错误处理：
# 1. 端口冲突解决：
lsof -i :80 | awk 'NR>1 {print $2}' | xargs kill -9
# 2. 数据库连接失败：
docker exec -it docker-db-1 psql -U postgres -c "CREATE USER dify WITH PASSWORD 'dify';"

yaml

bash

# 创建MCP配置文件：
mkdir -p /etc/dify/mcp && cat > /etc/dify/mcp/config.yaml <<EOF
dify_base_url: "http://localhost:80"
dify_app_sks:
  - "app-sk-xxxx"
EOF

# 启动MCP服务容器：
docker run -d --name dify-mcp \
  -v /etc/dify/mcp:/config \
  -p 8080:8080 \
  mcp-server:latest \
  --config /config/config.yaml

python

from mcp import FastMCP

mcp = FastMCP("财务工具集")

@mcp.tool()
def tax_calculator(income: float, region: str) -> dict:
    """个税计算工具"""
    # 对接本地财务系统API
    tax_data = requests.get(f"http://erp.internal/{region}/tax").json()
    return {
        "应纳税额": income * tax_data['rate'],
        "税率": tax_data['rate']
    }

if __name__ == "__main__":
    mcp.run(transport='http', port=8081)

bash

# 测试MCP服务连通性：
curl -X POST http://localhost:8080/tools/list \
  -H "Authorization: Bearer app-sk-xxxx" \
  -d '{"service_type": "finance"}'

# 预期返回：
{"tools": ["tax_calculator", "report_generator"], "status": 200}

nginx

# Nginx反向代理配置示例
location /mcp/ {
    proxy_pass http://dify-mcp:8080;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_ssl_session_reuse off;
    proxy_ssl_verify on;
    proxy_ssl_trusted_certificate /etc/ssl/certs/ca-certificates.crt;
}

yaml

# Prometheus监控配置示例
scrape_configs:
  - job_name: 'dify'
    static_configs:
      - targets: ['dify-api:5001', 'dify-worker:5002']
  - job_name: 'mcp'
    static_configs:
      - targets: ['dify-mcp:8080']

bash

docker exec -it docker-weaviate-1 \
  curl -X POST http://localhost:8080/v1/schema/reload

python

# 修改dify-api/config/rag.py
CHUNK_SIZE = 800  # 原值500
OVERLAP = 200     # 原值100

bash

# 查看Ollama日志：
docker logs ollama | grep -C 10 "ERROR"

# 测试模型基础功能：
curl http://localhost:11434/api/generate -d '{
  "model": "deepseek-r1",
  "prompt": "1+1等于几？"
}'