Metadata-Version: 2.4
Name: hairuo-mcp-hello-world
Version: 0.1.1
Summary: Minimal MCP server (stdio) for testing: input name, fixed output hello world
Project-URL: Homepage, https://github.com/example/mcp-hello-world
Project-URL: Repository, https://github.com/example/mcp-hello-world
Author: mcp-scope
License-Expression: MIT
License-File: LICENSE
Keywords: hello-world,mcp,model-context-protocol,stdio
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: mcp<2,>=1.27
Description-Content-Type: text/markdown

# mcp-hello-world

最小 MCP Server（仅 **stdio**），用于联调测试：

- 工具：`greet`
- 输入：`name`（姓名）
- 输出：固定 `hello world`（与 name 无关）

## 本地开发

```bash
cd mcp_scope
uv sync
uv run hairuo-mcp-hello-world
```

## uvx（发布后）

```bash
uvx hairuo-mcp-hello-world
```

## MCP 客户端 stdio 配置示例

### Cursor / Claude Desktop

```json
{
  "mcpServers": {
    "hello-world": {
      "command": "uvx",
      "args": ["mcp-hello-world"]
    }
  }
}
```

### 本地未发布时（用 uv run）

```json
{
  "mcpServers": {
    "hello-world": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp_scope", "hairuo-mcp-hello-world"]
    }
  }
}
```

### 使用已构建的 venv

```json
{
  "mcpServers": {
    "hello-world": {
      "command": "/path/to/mcp_scope/.venv/bin/hairuo-mcp-hello-world",
      "args": []
    }
  }
}
```

## 发布到 PyPI

```bash
uv build
uv publish
```

首次发布需配置 PyPI token：`uv publish --token pypi-...` 或设置 `UV_PUBLISH_TOKEN`。

## 工具说明

| 工具 | 参数 | 返回值 |
|------|------|--------|
| `greet` | `name: str` | `hello world` |
