Cloudpods/backend/docs/mcp-server/安装文档.md

---

sidebar_position: 6

MCP Server部署

MCP Server初始化

1) 首先配置MCP Server的配置文件

# 编译mcp-server 
$ cd /root/cloudpods && make cmd/mcp-server

# 编写mcp-server服务的配置文件
$ mkdir -p /etc/yunion/mcp-server
# 编写配置文件，注意根据实际情况修改Cloudpods API的认证信息
# 需要在系统内先创建mcp-server-admin用户，并以admin角色加入到system项目
$ cat<<EOF >/etc/yunion/mcp-server/mcp-server.conf
# ==================== 服务器基础配置 ====================
address = '127.0.0.1'
port = 12001
admin_domain = Default
admin_password = X8SXBkwkK3WtbSUA
admin_project = system
admin_project_domain = Default
admin_user = mcp-server-admin
auth_url = https://<ip_or_domain_of_apigatway>:30500/v3
session_endpoint_type = public


# ==================== MCP 服务配置 ====================
mcp_server_name = cloudpods-mcp-server    # MCP 服务名称（默认：cloudpods-mcp-server）
mcp_server_version = 1.0.0                # MCP 服务版本（默认：1.0.0）
mcp_server_description = the mcp server of the cloudpods server  # MCP 服务描述（默认）

2) 启动MCP Server服务

# 启动mcp-server服务
# 默认会从以下路径查找配置文件: /etc/yunion/mcp-server/mcp-server.yaml, ./config/mcp-server.yaml, ./mcp-server.yaml
$ /root/cloudpods/bin/mcp-server --log-level debug

# 或者使用 --conf 参数指定配置文件路径
$ /root/cloudpods/bin/mcp-server --log-level debug --conf /etc/yunion/mcp-server/mcp-server.yaml

验证服务

MCP Server启动后，可以通过以下方式验证服务是否正常运行：

# 检查服务是否监听在指定端口
$ curl http://localhost:12001/sse