AI导哈

天气查询工具

一个简单的Python项目，提供天气查询功能，可通过客户端或MCP CLI运行，支持开发模式下的实时重载和调试。

  • by akaiserg
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 akaiserg/hello-world-mcp

使用说明

你好世界mcp

描述

一个打印hello消息的简单Python项目。

需求

  • Python 3.11或更高版本

设置

创建并激活虚拟环境（推荐）：

python3 -m venv .venv
source .venv/bin/activate

安装依赖项

如果您需要安装 mcp[cli] 另外，使用引号来避免shell错误：

uv add 'mcp[cli]'

注： zsh中需要引号，以防止括号扩展错误。

如何跑步

运行客户端

client.py 连接到 weather.py 使用stdio的服务器，列出可用工具，并调用 get_weather 带有样品位置的工具。

python client.py

或者用uv运行客户端

跑步 uv 确保所有依赖关系都由uv管理：

uv run client.py

使用MCP CLI

要运行 weather.py 服务器处于开发模式，具有实时重新加载和MCP Inspector UI，请使用：

mcp dev weather.py

这将在本地启动您的MCP服务器，并在以下位置打开检查器http://localhost:6274用于测试和调试您的工具。

主机配置示例

如果您需要配置主机/服务器条目（例如，用于Claude Desktop或类似工具），请使用以下示例：

"weather": {
  "command": "uv",
  "args": [
    "--directory",
    "/path",
    "run",
    "weather.py"
  ]
}

此配置告诉主机使用 uv 运行 weather.py 从项目目录中，确保所有依赖项都可用。

故障排除

MCP检查器连接错误

如果在MCP Inspector中看到请求代理会话令牌的连接错误，请确保使用包含令牌的服务器URL启动Inspector，如下所示：

http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=YOUR_TOKEN_HERE#resources

例子：

http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=1f874aa0441c94cb870f4b4a14c3f5b76e5a814e422ba86687a98396b7fb5846#resources

替换 YOUR_TOKEN_HERE 使用您的实际会话令牌。

相关 MCP