[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73473":3},{"id":4,"name":5,"fullName":6,"owner":5,"repo":5,"description":7,"homepage":8,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":45,"readmeContent":46,"aiSummary":47,"trendingCount":15,"starSnapshotCount":15,"syncStatus":48,"lastSyncTime":49,"discoverSource":50},73473,"mcp-use","mcp-use\u002Fmcp-use","The fullstack MCP framework to develop MCP Apps for ChatGPT \u002F Claude & MCP Servers for AI Agents.","https:\u002F\u002Fmanufact.com",null,"TypeScript",10086,1323,89,42,0,24,68,157,72,119.37,"MIT License",false,"main",[25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"agentic-framework","ai","apps-sdk","chatgpt","claude-code","llms","mcp","mcp-apps","mcp-client","mcp-gateway","mcp-host","mcp-inspector","mcp-server","mcp-servers","mcp-tools","mcp-ui","model-context-protocol","modelcontextprotocol","openclaw","skills","2026-06-12 04:01:09","\u003Cdiv align=\"center\">\n\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fmcp-use.com\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\".\u002Fstatic\u002Flogo_white.svg\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\".\u002Fstatic\u002Flogo_black.svg\">\n      \u003Cimg alt=\"mcp use logo\" src=\".\u002Fstatic\u002Flogo_black.svg\" width=\"60%\" >\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n \n\n\u003Cp align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fmcp-use.com\u002Fdocs\" alt=\"Documentation\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fmcp--use-docs-blue?labelColor=white\" \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fmanufact.com\" alt=\"Website\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fmade by-manufact.com-blue\" \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Fblob\u002Fmain\u002FLICENSE\" alt=\"License\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fmcp-use\u002Fmcp-use\" \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FXkNkSkMz3V\" alt=\"Discord\">\n        \u003Cimg src=\"https:\u002F\u002Fdcbadge.limes.pink\u002Fapi\u002Fserver\u002FXkNkSkMz3V?style=flat\" \u002F>\u003C\u002Fa>\n    \u003Cbr\u002F>\n    \u003Ca href=\"https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Fpython\" alt=\"Python docs\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-docs-blue?labelColor=white&logo=python\" alt=\"Badge\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fmcp_use\u002F\" alt=\"PyPI Version\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fmcp_use.svg\"\u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fmcp_use\u002F\" alt=\"PyPI Downloads\">\n        \u003Cimg src=\"https:\u002F\u002Fstatic.pepy.tech\u002Fbadge\u002Fmcp-use\" \u002F>\u003C\u002Fa>\n    \u003Cbr\u002F>\n    \u003Ca href=\"https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Ftypescript\" alt=\"Typescript Documentation\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftypescript-docs-blue?labelColor=white&logo=typescript\" alt=\"Badge\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmcp-use\" alt=\"NPM Version\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fmcp-use.svg\"\u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmcp-use\" alt=\"NPM Downloads\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdw\u002Fmcp-use.svg\"\u002F>\u003C\u002Fa>\n    \u003Cbr\u002F>\n\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n##  About\n\n  \u003Cb>mcp-use\u003C\u002Fb> is the fullstack MCP framework\n  to build MCP Apps for ChatGPT \u002F Claude & MCP Servers for AI Agents.\n\n- **Build** with mcp-use SDK ([ts](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmcp-use) | [py](https:\u002F\u002Fpypi.org\u002Fproject\u002Fmcp_use\u002F)): MCP Servers and MCP Apps\n- **Preview** on mcp-use MCP Inspector ([online](https:\u002F\u002Finspector.mcp-use.com\u002Finspector) | [oss](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Ftree\u002Fmain\u002Flibraries\u002Ftypescript\u002Fpackages\u002Finspector)): Test and debug your MCP Servers and Apps\n- **Deploy** on [Manufact MCP Cloud](https:\u002F\u002Fmanufact.com): Connect your GitHub repo and have your MCP Server and App up and running in production with observability, metrics, logs, branch-deployments, and more\n\n## Documentation\n\nVisit our [docs](https:\u002F\u002Fmcp-use.com\u002Fdocs) or jump to a quickstart ([TypeScript](https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Ftypescript\u002Fgetting-started\u002Fquickstart) | [Python](https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Fpython\u002Fgetting-started\u002Fquickstart))\n\n### Skills for Coding Agents\n\n> **Using Claude Code, Codex, Cursor or other AI coding agents?**\n>\n> **[Install mcp-use skill for MCP Apps](https:\u002F\u002Fskills.sh\u002Fmcp-use\u002Fmcp-use\u002Fmcp-apps-builder)**\n\n## Quickstart: MCP Servers and MCP Apps\n\n### \u003Cimg src=\".\u002Fstatic\u002Ftypescript.svg\" height=\"14\" style=\"margin-right:4px; top:-1px; position:relative;\" align=\"center\" \u002F> TypeScript\n\nBuild your first MCP Server or MPC App:\n\n```bash\nnpx create-mcp-use-app@latest\n```\n\nOr create a server manually:\n\n```typescript\nimport { MCPServer, text } from \"mcp-use\u002Fserver\";\nimport { z } from \"zod\";\n\nconst server = new MCPServer({\n  name: \"my-server\",\n  version: \"1.0.0\",\n});\n\nserver.tool({\n  name: \"get_weather\",\n  description: \"Get weather for a city\",\n  schema: z.object({ city: z.string() }),\n}, async ({ city }) => {\n  return text(`Temperature: 72°F, Condition: sunny, City: ${city}`);\n});\n\nawait server.listen(3000);\n\u002F\u002F Inspector at http:\u002F\u002Flocalhost:3000\u002Finspector\n```\n\n[**→ Full TypeScript Server Documentation**](https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Ftypescript\u002Fserver)\n\n## MCP Apps\n\nMCP Apps let you build interactive widgets that work across Claude, ChatGPT, and other MCP clients — write once, run everywhere.\n\n**Server**: define a tool and point it to a widget:\n\n```typescript\nimport { MCPServer, widget } from \"mcp-use\u002Fserver\";\nimport { z } from \"zod\";\n\nconst server = new MCPServer({\n  name: \"weather-app\",\n  version: \"1.0.0\",\n});\n\nserver.tool({\n  name: \"get-weather\",\n  description: \"Get weather for a city\",\n  schema: z.object({ city: z.string() }),\n  widget: \"weather-display\", \u002F\u002F references resources\u002Fweather-display\u002Fwidget.tsx\n}, async ({ city }) => {\n  return widget({\n    props: { city, temperature: 22, conditions: \"Sunny\" },\n    message: `Weather in ${city}: Sunny, 22°C`,\n  });\n});\n\nawait server.listen(3000);\n```\n\n**Widget**: create a React component in `resources\u002Fweather-display\u002Fwidget.tsx`:\n\n```tsx\nimport { useWidget, type WidgetMetadata } from \"mcp-use\u002Freact\";\nimport { z } from \"zod\";\n\nconst propSchema = z.object({\n  city: z.string(),\n  temperature: z.number(),\n  conditions: z.string(),\n});\n\nexport const widgetMetadata: WidgetMetadata = {\n  description: \"Display weather information\",\n  props: propSchema,\n};\n\nconst WeatherDisplay: React.FC = () => {\n  const { props, isPending, theme } = useWidget\u003Cz.infer\u003Ctypeof propSchema>>();\n  const isDark = theme === \"dark\";\n\n  if (isPending) return \u003Cdiv>Loading...\u003C\u002Fdiv>;\n\n  return (\n    \u003Cdiv style={{\n      background: isDark ? \"#1a1a2e\" : \"#f0f4ff\",\n      borderRadius: 16, padding: 24,\n    }}>\n      \u003Ch2>{props.city}\u003C\u002Fh2>\n      \u003Cp>{props.temperature}° — {props.conditions}\u003C\u002Fp>\n    \u003C\u002Fdiv>\n  );\n};\n\nexport default WeatherDisplay;\n```\n\nWidgets in `resources\u002F` are **auto-discovered** — no manual registration needed.\n\nVisit [**MCP Apps Documentation**](https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Ftypescript\u002Fserver\u002Fmcp-apps)\n\n## Templates\n\nReady-to-use MCP Apps you can deploy in one click or remix as your own.\n\n| Preview | Name | Tools | Demo URL | Repo | Deploy |\n| --- | --- | --- | --- | --- | --- |\n| ![Chart Builder](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-chart-builder\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Chart Builder | `create-chart` | [Open URL](https:\u002F\u002Fyellow-shadow-21833.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-chart-builder](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-chart-builder) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-chart-builder&branch=main&project-name=mcp-chart-builder&port=3000&runtime=node&base-image=node%3A20) |\n| ![Diagram Builder](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-diagram-builder\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Diagram Builder | `create-diagram`, `edit-diagram` | [Open URL](https:\u002F\u002Flucky-darkness-402ph.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-diagram-builder](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-diagram-builder) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-diagram-builder&branch=main&project-name=mcp-diagram-builder&port=3000&runtime=node&base-image=node%3A20) |\n| ![Slide Deck](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-slide-deck\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Slide Deck | `create-slides`, `edit-slide` | [Open URL](https:\u002F\u002Fsolitary-block-r6m6x.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-slide-deck](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-slide-deck) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-slide-deck&branch=main&project-name=mcp-slide-deck&port=3000&runtime=node&base-image=node%3A20) |\n| ![Maps Explorer](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-maps-explorer\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Maps Explorer | `show-map`, `get-place-details`, `add-markers` | [Open URL](https:\u002F\u002Fsuper-night-ttde2.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-maps-explorer](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-maps-explorer) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-maps-explorer&branch=main&project-name=mcp-maps-explorer&port=3000&runtime=node&base-image=node%3A20) |\n| ![Hugging Face Spaces](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-huggingface-spaces\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Hugging Face Spaces | `search-spaces`, `show-space`, `trending-spaces` | [Open URL](https:\u002F\u002Fgentle-frost-pvxpk.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-huggingface-spaces](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-huggingface-spaces) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-huggingface-spaces&branch=main&project-name=mcp-huggingface-spaces&port=3000&runtime=node&base-image=node%3A20) |\n| ![Recipe Finder](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-recipe-finder\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Recipe Finder | `search-recipes`, `get-recipe`, `meal-plan`, `recipe-suggestion` | [Open URL](https:\u002F\u002Fbold-tree-1fe79.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-recipe-finder](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-recipe-finder) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-recipe-finder&branch=main&project-name=mcp-recipe-finder&port=3000&runtime=node&base-image=node%3A20) |\n| ![Widget Gallery](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-widget-gallery\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Widget Gallery | `show-react-widget`, `html-greeting`, `mcp-ui-poll`, `programmatic-counter`, `detect-client` | [Open URL](https:\u002F\u002Fwandering-lake-mmxhs.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-widget-gallery](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-widget-gallery) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-widget-gallery&branch=main&project-name=mcp-widget-gallery&port=3000&runtime=node&base-image=node%3A20) |\n| ![Multi Server Hub](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-multi-server-hub\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Multi Server Hub | `hub-status`, `hub-config-example`, `audit-log` | [Open URL](https:\u002F\u002Fsoft-voice-4nxfi.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-multi-server-hub](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-multi-server-hub) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-multi-server-hub&branch=main&project-name=mcp-multi-server-hub&port=3000&runtime=node&base-image=node%3A20) |\n| ![File Manager](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-file-manager\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | File Manager | `open-vault`, `get-file`, `list-files` | [Open URL](https:\u002F\u002Fmuddy-pond-eyays.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-file-manager](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-file-manager) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-file-manager&branch=main&project-name=mcp-file-manager&port=3000&runtime=node&base-image=node%3A20) |\n| ![Progress Demo](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-progress-demo\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Progress Demo | `process-data`, `fetch-report`, `delete-dataset`, `search-external`, `failing-tool` | [Open URL](https:\u002F\u002Fcrimson-river-pzsz1.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-progress-demo](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-progress-demo) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-progress-demo&branch=main&project-name=mcp-progress-demo&port=3000&runtime=node&base-image=node%3A20) |\n| ![i18n Adaptive](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-i18n-adaptive\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | i18n Adaptive | `show-context`, `detect-caller` | [Open URL](https:\u002F\u002Ffalling-grass-58yov.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-i18n-adaptive](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-i18n-adaptive) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-i18n-adaptive&branch=main&project-name=mcp-i18n-adaptive&port=3000&runtime=node&base-image=node%3A20) |\n| ![Media Mixer](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-media-mixer\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Media Mixer | `generate-image`, `generate-audio`, `generate-pdf`, `get-report`, `get-html-snippet`, `get-xml-config`, `get-stylesheet`, `get-script`, `get-data-array` | [Open URL](https:\u002F\u002Fwandering-breeze-nuipu.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-media-mixer](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-media-mixer) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-media-mixer&branch=main&project-name=mcp-media-mixer&port=3000&runtime=node&base-image=node%3A20) |\n| ![Resource Watcher](https:\u002F\u002Fraw.githubusercontent.com\u002Fmcp-use\u002Fmcp-resource-watcher\u002Fmain\u002Frepo-assets\u002Fdemo.gif) | Resource Watcher | `show-config`, `update-config`, `toggle-feature`, `list-roots` | [Open URL](https:\u002F\u002Ffragrant-term-zmdks.run.mcp-use.com\u002Fmcp) | [mcp-use\u002Fmcp-resource-watcher](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-resource-watcher) | [![Deploy to mcp-use](https:\u002F\u002Fcdn.mcp-use.com\u002Fdeploy.svg)](https:\u002F\u002Fmcp-use.com\u002Fdeploy\u002Fstart?repository-url=https%3A%2F%2Fgithub.com%2Fmcp-use%2Fmcp-resource-watcher&branch=main&project-name=mcp-resource-watcher&port=3000&runtime=node&base-image=node%3A20) |\n\n---\n### \u003Cimg src=\".\u002Fstatic\u002Fpython.svg\" height=\"14\" style=\"margin-right:4px; top:-1px; position:relative;\" align=\"center\" \u002F> Python\n\n```bash\npip install mcp-use\n```\n\n```python\nfrom typing import Annotated\n\nfrom mcp.types import ToolAnnotations\nfrom pydantic import Field\n\nfrom mcp_use import MCPServer\n\nserver = MCPServer(name=\"Weather Server\", version=\"1.0.0\")\n\n@server.tool(\n    name=\"get_weather\",\n    description=\"Get current weather information for a location\",\n    annotations=ToolAnnotations(readOnlyHint=True, openWorldHint=True),\n)\nasync def get_weather(\n    city: Annotated[str, Field(description=\"City name\")],\n) -> str:\n    return f\"Temperature: 72°F, Condition: sunny, City: {city}\"\n\n# Start server with auto-inspector\nserver.run(transport=\"streamable-http\", port=8000)\n# 🎉 Inspector at http:\u002F\u002Flocalhost:8000\u002Finspector\n```\n\n[**→ Full Python Server Documentation**](https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Fpython\u002Fserver\u002Findex)\n\n---\n\n## Inspector\n\nThe mcp-use Inspector lets you test and debug your MCP servers interactively.\n\n**Auto-included** when using `server.listen()`:\n\n```typescript\nserver.listen(3000);\n\u002F\u002F Inspector at http:\u002F\u002Flocalhost:3000\u002Finspector\n```\n\n**Online** when connecting to hosted MCP servers:\n\u003Cbr>\n>Visit https:\u002F\u002Finspector.mcp-use.com\n\n**Standalone**: inspect any MCP server:\n\n```bash\nnpx @mcp-use\u002Finspector --url http:\u002F\u002Flocalhost:3000\u002Fmcp\n```\n\nVisit [**Inspector Documentation**](https:\u002F\u002Fmcp-use.com\u002Fdocs\u002Finspector\u002Findex)\n\n---\n\n## Deploy\n\nDeploy your MCP server to production:\n\n```bash\nnpx @mcp-use\u002Fcli login\nnpx @mcp-use\u002Fcli deploy\n```\n\nOr connect your GitHub repo on [manufact.com](https:\u002F\u002Fmanufact.com) — production-ready with observability, metrics, logs, and branch-deployments.\n\n---\n\n## Package Overview\n\nThis monorepo contains multiple packages for both Python and TypeScript:\n\n### Python Packages\n\n| Package     | Description                           | Version                                                                                 |\n| ----------- | ------------------------------------- | --------------------------------------------------------------------------------------- |\n| **mcp-use** | Complete MCP server and MCP agent SDK | [![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fmcp_use.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fmcp_use\u002F) |\n\n### TypeScript Packages\n\n| Package                | Description                                     | Version                                                                                                         |\n| ---------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |\n| **mcp-use**            | Core framework for MCP servers, MCP apps, and MCP agents | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fmcp-use.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmcp-use)                       |\n| **@mcp-use\u002Fcli**       | Build tool with hot reload and auto-inspector   | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@mcp-use\u002Fcli.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@mcp-use\u002Fcli)             |\n| **@mcp-use\u002Finspector** | Web-based previewer and debugger for MCP servers              | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@mcp-use\u002Finspector.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@mcp-use\u002Finspector) |\n| **create-mcp-use-app** | Project scaffolding tool                        | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fcreate-mcp-use-app.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fcreate-mcp-use-app) |\n\n---\n\n## Also: MCP Agent & Client\n\nmcp-use also provides a full MCP Agent and Client implementation.\n\n\u003Cdetails>\n\u003Csummary>Build an AI Agent\u003C\u002Fsummary>\n\n### \u003Cimg src=\".\u002Fstatic\u002Fpython.svg\" height=\"14\" style=\"margin-right:4px; top:-1px; position:relative;\" align=\"center\" \u002F> Python\n\n```bash\npip install mcp-use langchain-openai\n```\n\n```python\nimport asyncio\nfrom langchain_openai import ChatOpenAI\nfrom mcp_use import MCPAgent, MCPClient\n\nasync def main():\n    config = {\n        \"mcpServers\": {\n            \"filesystem\": {\n                \"command\": \"npx\",\n                \"args\": [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Ftmp\"]\n            }\n        }\n    }\n\n    client = MCPClient.from_dict(config)\n    llm = ChatOpenAI(model=\"gpt-4o\")\n    agent = MCPAgent(llm=llm, client=client)\n\n    result = await agent.run(\"List all files in the directory\")\n    print(result)\n\nasyncio.run(main())\n```\n\n[**→ Full Python Agent Documentation**](.\u002Flibraries\u002Fpython\u002FREADME.md#quick-start)\n\n### \u003Cimg src=\".\u002Fstatic\u002Ftypescript.svg\" height=\"14\" style=\"margin-right:4px; top:-1px; position:relative;\" align=\"center\" \u002F> TypeScript\n\n```bash\nnpm install mcp-use @langchain\u002Fopenai\n```\n\n```typescript\nimport { ChatOpenAI } from \"@langchain\u002Fopenai\";\nimport { MCPAgent, MCPClient } from \"mcp-use\";\n\nasync function main() {\n  const config = {\n    mcpServers: {\n      filesystem: {\n        command: \"npx\",\n        args: [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Ftmp\"],\n      },\n    },\n  };\n\n  const client = MCPClient.fromDict(config);\n  const llm = new ChatOpenAI({ modelName: \"gpt-4o\" });\n  const agent = new MCPAgent({ llm, client });\n\n  const result = await agent.run(\"List all files in the directory\");\n  console.log(result);\n}\n\nmain();\n```\n\n[**→ Full TypeScript Agent Documentation**](.\u002Flibraries\u002Ftypescript\u002FREADME.md#-quick-start)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Use MCP Client\u003C\u002Fsummary>\n\n### \u003Cimg src=\".\u002Fstatic\u002Fpython.svg\" height=\"14\" style=\"margin-right:4px; top:-1px; position:relative;\" align=\"center\" \u002F> Python\n\n```python\nimport asyncio\nfrom mcp_use import MCPClient\n\nasync def main():\n    config = {\n        \"mcpServers\": {\n            \"calculator\": {\n                \"command\": \"npx\",\n                \"args\": [\"-y\", \"@modelcontextprotocol\u002Fserver-everything\"]\n            }\n        }\n    }\n\n    client = MCPClient.from_dict(config)\n    await client.create_all_sessions()\n\n    session = client.get_session(\"calculator\")\n    result = await session.call_tool(name=\"add\", arguments={\"a\": 5, \"b\": 3})\n\n    print(f\"Result: {result.content[0].text}\")\n    await client.close_all_sessions()\n\nasyncio.run(main())\n```\n\n[**→ Python Client Documentation**](.\u002Flibraries\u002Fpython\u002FREADME.md#direct-tool-calls-without-llm)\n\n### \u003Cimg src=\".\u002Fstatic\u002Ftypescript.svg\" height=\"14\" style=\"margin-right:4px; top:-1px; position:relative;\" align=\"center\" \u002F> TypeScript\n\n```typescript\nimport { MCPClient } from \"mcp-use\";\n\nasync function main() {\n  const config = {\n    mcpServers: {\n      calculator: {\n        command: \"npx\",\n        args: [\"-y\", \"@modelcontextprotocol\u002Fserver-everything\"],\n      },\n    },\n  };\n\n  const client = new MCPClient(config);\n  await client.createAllSessions();\n\n  const session = client.getSession(\"calculator\");\n  const result = await session.callTool(\"add\", { a: 5, b: 3 });\n\n  console.log(`Result: ${result.content[0].text}`);\n  await client.closeAllSessions();\n}\n\nmain();\n```\n\n[**→ TypeScript Client Documentation**](.\u002Flibraries\u002Ftypescript\u002FREADME.md#basic-usage)\n\n\u003C\u002Fdetails>\n\n---\n\n## Conformance to Model Context Protocol\n\n\u003Cdiv align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Factions\u002Fworkflows\u002Fconformance.yml\" alt=\"Python MCP Conformance\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https:\u002F\u002Fgist.githubusercontent.com\u002Ftonxxd\u002F6edf670f0446dc9f7a1f32d6bfda2b70\u002Fraw\u002Fpython-conformance.json\" \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Factions\u002Fworkflows\u002Fconformance.yml\" alt=\"Python MCP Client Conformance\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https:\u002F\u002Fgist.githubusercontent.com\u002Ftonxxd\u002F6edf670f0446dc9f7a1f32d6bfda2b70\u002Fraw\u002Fpython-client-conformance.json\" \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Factions\u002Fworkflows\u002Fconformance.yml\" alt=\"TypeScript MCP Conformance\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https:\u002F\u002Fgist.githubusercontent.com\u002Ftonxxd\u002F6edf670f0446dc9f7a1f32d6bfda2b70\u002Fraw\u002Ftypescript-conformance.json\" \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Factions\u002Fworkflows\u002Fconformance.yml\" alt=\"TypeScript MCP Client Conformance\">\n      \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https:\u002F\u002Fgist.githubusercontent.com\u002Ftonxxd\u002F6edf670f0446dc9f7a1f32d6bfda2b70\u002Fraw\u002Ftypescript-node-client-conformance.json\" \u002F>\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n---\n\n## Security\nSee [SECURITY.md](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Fblob\u002Fmain\u002FSECURITY.md)\n\n## Community & Support\n\n- **Discord**: [Join our community](https:\u002F\u002Fdiscord.gg\u002FXkNkSkMz3V)\n- **GitHub Issues**: [Report bugs or request features](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Fissues)\n- **Documentation**: [mcp-use.com\u002Fdocs](https:\u002F\u002Fmcp-use.com\u002Fdocs)\n- **Website**: [manufact.com](https:\u002F\u002Fmanufact.com)\n- **X.com**: Follow [Manufact](https:\u002F\u002Fx.com\u002Fmanufact)\n- **Contributing**: See [CONTRIBUTING.md](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Fblob\u002Fmain\u002FCONTRIBUTING.md)\n- **License**: MIT © [MCP-Use Contributors](https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Fgraphs\u002Fcontributors)\n\n---\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=mcp-use\u002Fmcp-use&type=Date)](https:\u002F\u002Fwww.star-history.com\u002F#mcp-use\u002Fmcp-use&Date)\n\n---\n\n## Contributors\n\nThanks to all our amazing contributors!\n\n### Core Contributors\n\n1. **Pietro** ([@pietrozullo](https:\u002F\u002Fgithub.com\u002Fpietrozullo))\n2. **Luigi** ([@pederzh](https:\u002F\u002Fgithub.com\u002Fpederzh))\n3. **Enrico** ([@tonxxd](https:\u002F\u002Fgithub.com\u002Ftonxxd))\n\n\u003Cbr>\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmcp-use\u002Fmcp-use\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=mcp-use\u002Fmcp-use\" \u002F>\n\u003C\u002Fa>\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Cstrong>Built with ❤️ by Manufact team and the mcp-use community\u003C\u002Fstrong>\n  \u003Cbr\u002F>\n  \u003Csub>San Francisco | Zürich\u003C\u002Fsub>\n\u003C\u002Fdiv>\n","mcp-use 是一个全栈MCP框架，用于开发适用于ChatGPT\u002FClaude等AI代理的MCP应用及服务器。它支持使用TypeScript或Python构建MCP应用和服务器，并提供了一个在线MCP Inspector工具来测试和调试这些应用。此外，通过连接到Manufact MCP Cloud，用户可以轻松地将GitHub仓库中的项目部署到生产环境，并获得包括可观测性、指标、日志等功能的支持。此项目特别适合需要为AI助手快速搭建对话式应用程序或服务的开发者。",2,"2026-06-11 03:45:44","high_star"]