用于 MCP 的 TypeScript 框架

构建、测试并交付 MCP 服务器、ChatGPT 插件和 Claude 连接器

完全类型化，原生支持 Views 和 MCP Apps，内置 Inspector，并提供一流的 Agent 体验。

文档 · Inspector · 示例 · 部署

[!NOTE] 正在从 v1 迁移？把它交给你的 agent：

Migrate this mcp-use project to v2 following
https://docs.mcp-use.com/v2/typescript/server/migration

阅读迁移指南 →

快速开始

从你的 Agent 开始

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

阅读提示词 →

从代码开始

npx -y create-mcp-use-app@latest

在生成的项目中运行 npm run dev · 打开 http://localhost:3000/mcp/inspector

TS 文档

交付 MCP 所需的一切

| 完全类型化 | 原生 Views | | --- | --- | | Zod schema 从工具流向结构化结果、View props 和工具调用。 | 将 React Views 直接绑定到工具，无需自定义扩展接线即可交付交互式应用。 | | Agent 优先且无头（headless） | 内置调试工具 | | 通过你的 agent 完成脚手架搭建、调用、检查、截图和部署。 | 在浏览器中或通过 CLI 以无头方式检查工具和 Views。 |

快速入门

脚手架为你提供服务器、TypeScript 配置、开发脚本、Inspector 和 React 视图管道。启动一次后，MCP 端点还会提供一个客户端就绪的落地页，其中包含连接 URL 和设置说明。

用如下绑定视图的工具替换其中的 index.ts：

index.ts — 服务器入口文件，用于工具定义和元数据

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;

探索 MCP 服务器工具 →

为你的工具添加 Views

创建 views/weather-card/view.tsx。目录名称与工具上的 view.name 匹配：