mcp-use

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Node.js 与 npm 环境（项目使用 npm 脚本和 TypeScript）
• 一个可用的 AI Agent 或编辑器，用于按提示词生成脚手架
• TypeScript 项目环境：脚手架已内置 tsconfig、开发脚本、Inspector 与 React 视图管线
• 如使用官方托管部署，需准备 Manufact 账号（npm run deploy）

安装与启动步骤

1. 1查阅官方文档

   先打开 mcp-use v2 TypeScript 快速开始文档，确认脚手架获取方式与版本要求；README 未给出安装命令。

2. 2用 Agent 生成脚手架

   README 推荐从 Agent 起步，把这段提示词交给 Agent 即可生成 MCP 服务器脚手架。

   Build an MCP server: https://mcp-use.com/prompt.md

   复制

3. 3编写服务入口 index.ts

   用视图绑定工具替换脚手架里的 index.ts，定义服务器元数据、工具输入输出 Schema 与返回值。

   import { MCPServer } from "mcp-use";
   import { z } from "zod";
   
   const server = new MCPServer({
     name: "weather-app",
     title: "Weather App",
     version: "1.0.0",
   });
   
   const weatherInput = z.object({
     city: z.string().describe("City to look up"),
   });
   
   const weatherOutput = z.object({
     city: z.string(),
     temperature: z.number(),
     conditions: z.string(),
   });
   
   export const getWeather = server.tool(
     {
       name: "get-weather",
       title: "Get weather",
       description: "Get the current weather for a city",
       inputSchema: weatherInput,
       outputSchema: weatherOutput,
       view: { name: "weather-card" },
       annotations: {
         readOnlyHint: true,
         destructiveHint: false,
         openWorldHint: true,
       },
     },
     async ({ city }) => {
       const weather = {
         city,
         temperature: 22,
         conditions: "Sunny",
       };
   
       return {
         content: [
           {
             type: "text",
             text: `Weather in ${city}: ${weather.conditions}, ${weather.temperature}°C`,
           },
         ],
         structuredContent: weather,
       };
     },
   );
   
   export default server;

   复制

4. 4启动开发服务

   用脚手架自带的开发脚本启动服务；README 未给出具体命令，请查看项目 package.json 的 scripts 字段。

5. 5部署到 Manufact

   可免费获得可观测性、分析、评测、提交就绪检查与基于 Git 的预览环境，需已登录账号。

   npm run deploy

   复制

关键配置

如何确认成功

服务启动后 MCP endpoint 会同时提供一个面向客户端的落地页，页面展示连接 URL 和接入说明，打开即可确认。

常见问题

注意事项

• README 节选未提供安装与创建脚手架的完整命令，请以官方文档为准，不要照抄网上其他教程。
• 示例中的天气数据为演示值（temperature 恒为 22），接入真实业务时需替换为实际数据源。
• npm run deploy 依赖 Manufact 平台账号，自托管请参考官方部署文档。
• README 中出现的是 v2 文档链接，升级前请确认项目当前版本。