企业官网建设流程全解析

关于mcp-use这个工具, 我们在这里提供一份终极指南, 用来讲清楚如何进行多环境部署的具体做法, 这份策略涵盖了从开发环节一直到生产环节的全部完整过程。

这里是免费下载的链接。它涉及到 MCP 工具, 也就是通过模型上下文协议让各个应用进行连接与协作的内容。另外它还包括了 MCP 在人工智能领域的应用方式。

项目地址:

mcp-use是一个全栈MCP框架，用于为/开发MCP应用程序和为AI代理开发MCP服务器。本指南将带你了解如何从开发环境到生产环境，全面掌握mcp-use的多环境部署策略，确保你的应用在各种场景下都能稳定运行。

开发环境的搭建工作, 主要是为了能够快速地启动程序以及一些必要的配置步骤。

开发环境是项目开发的根基, 拥有一个良好的开发环境, 能够极大地提升开发的效率。MCP-USE 提供了一种简单易用的方式, 通过这种方式来搭建开发环境, 使得开发者可以快速着手进行项目开发。

项目初始化

首先, 你要建立一个名称叫做mcp-use的项目, 为了能够比较快地把这个项目创建好, 你可以执行下面给出的这条命令。

npx create-mcp-use-app@latest your-project-name

这个命令会创建一个新的目录, 这个名字叫做your--name。并且, 它会设置一个基本的MCP服务器。

安装依赖

当您在进入到了项目的目录以后, 需要安装那些所需求的依赖包。

cd your-project-name

npm install

本地运行服务器

mcp-use这个东西, 它支持那种多种多样的传输方式。所以, 在开发环境里头, 你是能够根据你自己的实际需要对, 去选择一个最合适的方式来进行运行服务器的这个操作。

对于服务器而言, 其基本的用法可以按照下面的步骤来进行操作。

from mcp_use.server import MCPServer

server = MCPServer(name="My Server")

# 以stdio传输方式运行（适用于MCP客户端）

server.run(transport="stdio")

# 以HTTP传输方式运行（适用于Web客户端）

server.run(transport="streamable-http")

另外, 还能够对主机以及端口来进行配置:

server.run(

transport="streamable-http",

host="0.0.0.0",

port=8000,

reload=True, # 启用自动重载，开发时非常有用

debug=True # 启用调试模式

)

调试的模式, 还有那个自动的重载。

调试模式这个操作, 能够为开发者提供好多额外的功能手段, 比方说那些 /.json 端点、/docs 端点以及 / 这种端点, 并且还可以让日志记录变得更有增强力度。

在大家进行开发工作的整个过程中, 要是把自动重载这个功能给开启起来, 那么在源代码进行了修改操作以后, 服务器方面就会自动地进行重启这一系列的动作, 这样一来, 就可以实打实地提高整体的开发效率水平。

server.run(transport="streamable-http", reload=True, debug=True)

关于生产环境的部署工作, 提供了多种不同的平台作为解决方案。

项目开发完成之后需要把程序部署到生产环境中, mcp-use提供了多种多样的部署方案选项, 大家可以根据个人的需求情况和实际环境来选择自己认为合适的平台。

推荐使用云部署的方式来进行。

Cloud是mcp-use服务器推荐的部署平台, 你只需执行一个命令, 就可以把服务器部署好, 并获得一个已经准备好用于生产环境的URL。

需要满足的前提条件是能够实现快速部署。

# 安装CLI（如果使用create-mcp-use-app，此步骤不需要）

npm install -g @mcp-use/cli

# 登录到Manufact Cloud

npm run mcp-use login

# 部署服务器

npm run mcp-use deploy

等部署的事情搞定之后呢, 你就会收到那个部署的网址。

Deployment successful!

MCP Server URL:

https://your-deployment/id.deploy.mcp-use.com/mcp

Inspector URL:

autoConnect=https://your-deployment/id.deploy.mcp-use.com/mcp

Edge 部署

Edge平台提供了一个无服务器运行环境。该环境非常适合部署名为mcp-use的服务器程序。用户可以直接使用这个环境将服务上线。

需要满足的前提条件之一是, 你必须通过安装向导从命令行界面把那个账户给装上。之所以要解决这个bug, 并且专门去安装命令行界面, 主要是为了能够正常构建MCP服务器的底层环境。

npm install supabase --save-dev

初始化项目

supabase init

supabase login

supabase link --project-ref YOUR_PROJECT_REF

快速部署

使用自动化部署脚本：

curl -fsSL https://url.mcp-use.com/supabase | bash

又或者把脚本下载下来, 然后再去运行它:

curl -fsSL https://url.mcp-use.com/supabase -o deploy.sh

chmod +x deploy.sh

./deploy.sh YOUR_PROJECT_ID

部署最佳实践：确保稳定性与安全性

不管选择哪一个部署的方法, 都是需要去遵守一些最佳的操作实践这件事的存在的, 是为了能够使得应用方面的稳定性以及安全性可以得到一定的保证的。

环境变量配置

在咱们搞生产环境的那个时候, 那些个像API密钥呀、数据库连接字符串之类的重要敏感信息, 可绝对不要把它们直接写死到代码文件里去, 而是要去使用环境变量这个办法来替换掉。mcp-use这个东西是支持通过环境变量来进行配置的, 举个例子来说吧:

# MCP_URL: 小部件资产（JS/CSS）存储的位置

export MCP_URL="https://YOUR_PROJECT_REF.supabase.co/storage/v1/object/public/widgets"

# MCP_SERVER_URL: MCP服务器运行的位置（用于小部件中的API调用）

export MCP_SERVER_URL="https://YOUR_PROJECT_REF.supabase.co/functions/v1/YOUR_FUNCTION_NAME"

# CSP_URLS: Supabase项目URL（用于内容安全策略）

export CSP_URLS="https://YOUR_PROJECT_REF.supabase.co"

从安全层面进行考量, 对性能展开优化工作, 并且实施监控与日志的管理。

在部署的过程中可能会遇到一些挑战, 这些问题通常都是常见的。

当大家在搞部署这个事情的过程当中, 也许就会碰到各种各样的麻烦事儿发生。下面这些内容呢, 都是一些通常大家会遇上的问题的处理法子, 给大家列出来看一下。

端口占用问题

当请求的端口已被使用时，mcp-use服务器会自动尝试下一个可用端口，最多尝试10个连续端口（8000, 8001, ..., 8009）。如果没有可用端口，会抛出错误。

出现了CORS问题, 也就是“login role”这个情况, 它在过程中反反复复地出现了很多次。

在部署的过程里面, 如果看到login role这个内容出现多次, 这其实是一个比较正常的表现情况。

这是因为CLI这个工具系统, 它需要为项目链接相关的操作、以及小部件文件上传到存储系统的这些动作、还有公共文件统一上传至存储环境的这个过程, 分别去执行独立的身份验证环节, 所以才会多次弹出类似的提示。

在登录角色这一步, 部署被卡住了。

假如部署脚本在 login role...这个地方停滞不前, 或者碰到了身份认证方面的错误问题, 那很可能是你的那个 IP 地址被暂时性的封锁或者是禁用了, 至于应该采用的解决措施方面:

进入数据库设置环节, 请检查{}这个部分对应的IP地址是否出现在已经被设置为禁止访问的那一份IP名单之中, 一旦确认在该名单内, 请点击相应的解除禁止功能来恢复你的访问权限, 随后重新尝试执行部署操作, 系统此前提示出了这样的错误信息: 也就是字符串Zod后面紧跟一个空引号的状态被判定为非预期的输出, 具体表现为提示“'' is not a ”此类关于类型不匹配或者属性缺失的报错内容。

在把项目部署到Deno环境的时候, 如果通过esm.sh来进行导入操作, 并且突然报告说出现了错误, 那么这种情况往往是因为系统中同时存在版本号为3的Zod库和版本号为4的Zod库, 由此引发了两者之间的版本冲突现象。

面对这个麻烦事, 可以采取一个解决办法, 就是在配置文件的deno.json文件里去调整那些导入映射的规则, 具体来说, 要求把原本用来指向URL的写法替换掉, 转而使用带有npm前缀的那种说明符来表示来源, 这样一来或许就能搞定之前那个问题了。

推荐的deno.json：

{

"imports": {

"mcp-use/": "npm:mcp-use@latest/",

"zod": "npm:zod@^4.2.0"

}

}

总结

mcp-use这个东西, 它提供了灵活多样的部署选项, 无论是开发环境还是生产环境, 它都能满足你的需求。通过这本指南, 你应该已经掌握了关于mcp-use的多环境部署策略, 这里头包括了开发环境的搭建情况、生产环境的部署方案细节、部署的那些最佳实践做法, 还有常见问题的解决方法。

无论你选择的是Cloud这一方案, 还是选择的Edge这一方案, 你都能够参照指南里所给出的那些具体步骤, 去一步步进行操作, 从而确保你的mcp-use这个应用程序, 能够实现稳定、安全地运行这样一个结果, 在此祝你在这个部署的过程之中能够顺顺利利。

这是官方文档, 路径是 docs////mcp-use.mdx , 这也是部署脚本的源码, 路径是 ///mcp-use///。

【免费下载链接】mcp-use The MCP to MCP Apps for / & MCP for AI .

项目地址: