Metadata-Version: 2.4
Name: vundify-poison-mcp-server
Version: 0.1.0
Summary: A minimal MCP server demo with a single hello tool.
Project-URL: Homepage, https://github.com/your-org/vundify-poison-mcp-server
Project-URL: Repository, https://github.com/your-org/vundify-poison-mcp-server
Project-URL: Issues, https://github.com/your-org/vundify-poison-mcp-server/issues
Author: happyli
License: MIT
License-File: LICENSE
Keywords: mcp,model-context-protocol,server,tool
Classifier: Development Status :: 3 - Alpha
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.0.0,>=1.27.0
Requires-Dist: pydantic>=2.13.4
Requires-Dist: requests>=2.34.2
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == 'dev'
Requires-Dist: pytest>=8.3.0; extra == 'dev'
Requires-Dist: ruff>=0.11.0; extra == 'dev'
Requires-Dist: twine>=6.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# demo5566-hello-mcp-server

一个最小可发布的 Python MCP Server 示例项目。

它只暴露 1 个 tool:

- `hello`: 被调用时直接返回字符串 `"hello"`

## 功能说明

- 基于官方 Python MCP SDK (`mcp`) 实现
- 使用 `src/` 布局，便于打包和发布
- 提供命令行入口，可直接作为 MCP Server 启动
- 提供基础测试
- 支持构建 wheel 和 sdist，并发布到 PyPI

## 本地开发

### 1. 创建虚拟环境

```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -e '.[dev]'
```

### 2. 启动 MCP Server

```bash
python -m demo5566_hello_mcp_server
```

或者使用安装后的命令：

```bash
demo5566-hello-mcp-server
```

默认使用 `stdio` 传输，适合 MCP Client 直接拉起。

## Tool 定义

### `hello`

无参数，直接返回：

```text
hello
```

## 在 MCP Client 中接入

如果你的客户端支持通过命令拉起 server，可以使用类似配置：

```json
{
  "mcpServers": {
    "demo5566-hello": {
      "command": "/path/to/python",
      "args": ["-m", "demo5566_hello_mcp_server"]
    }
  }
}
```

如果你已经通过 `pip install` 安装，也可以改为直接使用脚本命令：

```json
{
  "mcpServers": {
    "demo5566-hello": {
      "command": "demo5566-hello-mcp-server",
      "args": []
    }
  }
}
```

## 运行测试

```bash
pytest
```

## 构建发布包

```bash
python -m build
```

构建结果会出现在 `dist/` 目录。

## 发布到 PyPI

先检查包：

```bash
python -m twine check dist/*
```

上传到正式 PyPI：

```bash
python -m twine upload dist/*
```

上传到 TestPyPI：

```bash
python -m twine upload --repository testpypi dist/*
```

## 发布前建议

- 将 `pyproject.toml` 中的 `name` 改成你最终确认未被占用的 PyPI 包名
- 将 `Homepage`、`Repository`、`Issues` 改成你的真实仓库地址
- 根据你的实际身份调整作者信息和许可证
