mcpField
H
Hello World (UV Runtime)

Hello World (UV Runtime)

已认证本地服务
github.com/modelcontextprotocol开发工具2.2k27 周前更新

关于 Hello World (UV Runtime)

Hello World UV Runtime 是一个最小化的 MCP 服务示例,使用 UV 运行时。它面向希望了解 Claude Desktop 扩展打包方式的开发者,并与 Python 运行时的传统做法形成对比。

主要功能

  1. 01使用 server.type = "uv" 配置
  2. 02依赖由 pyproject.toml 声明,无需内置
  3. 03打包体积小,约 2 KB
  4. 04通过 uv run 自动解析依赖

适用场景

  1. 01学习 MCP 服务的基本结构
  2. 02作为 Claude Desktop 扩展的起始模板
  3. 03对比 UV 与 Python 运行时的打包差异

MCP 相关

该示例提供名为 say_hello 的 MCP 工具,用于按名字问候用户,可在 Claude Desktop 中以扩展形式安装。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Hello World UV Runtime 示例

此示例演示了如何使用 UV runtime 创建最简 MCP 服务。

什么是 UV Runtime?

UV runtime 可让 Claude Desktop 自动为你的扩展管理 Python 和依赖项:

  • 为用户的平台下载正确的 Python 版本
  • 创建隔离的虚拟环境
  • 从 pyproject.toml 安装依赖项
  • 可跨平台使用(Windows、macOS、Linux),无需用户进行设置

结构

hello-world-uv/
├── manifest.json       # server.type = "uv"
├── pyproject.toml      # Dependencies listed here
├── .mcpbignore        # Exclude build artifacts
└── src/
    └── server.py       # MCP server implementation

与 Python Runtime 的主要区别

UV Runtime(此示例):

  • server.type = "uv"
  • 不捆绑依赖项
  • mcp_config 使用 uv run 从 pyproject.toml 自动解析依赖项
  • 软件包体积小(约 2 KB)
  • 可在任何平台上运行

Python Runtime(传统方式):

  • server.type = "python"
  • 必须将依赖项捆绑在 server/lib/ 中
  • 需要在 mcp_config 中设置 PYTHONPATH
  • 软件包体积较大
  • 仅适用于纯 Python(无编译依赖项)

安装

mcpb pack

在 Claude Desktop 中安装生成的 .mcpb 文件。

本地测试

# Install dependencies
uv sync

# Run server
uv run src/server.py

工具

  • say_hello - 根据姓名向某人问好

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。