Metadata-Version: 2.4
Name: hexagram-mcp-service
Version: 0.1.3
Summary: A small Python MCP service ready for Alibaba Cloud Bailian custom MCP deployment.
Author: Your Team
Project-URL: Homepage, https://example.com
Project-URL: Repository, https://example.com/repository
Project-URL: Issues, https://example.com/issues
Keywords: mcp,aliyun,bailian,model-context-protocol
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# Alibaba Cloud MCP Service

这是一个可以发布到 PyPI，并通过 `uvx` 在阿里云百炼自定义 MCP 中部署的 Python 服务。

## 特点

- 默认使用 `stdio` 运行，适合阿里云的脚本部署方式
- 同时保留 `streamable-http` 模式，方便本地调试或后续扩展
- 提供了一个工具、一个资源和一个提示词，便于快速验证部署是否成功

## 打包发布

先构建包：

```bash
uv build
```

然后发布到 PyPI：

```bash
uv publish
```

如果你还没有配置 PyPI 凭据，可以先按 `uv` 的发布流程登录或设置 token，再执行发布。

## 本地运行

先安装依赖：

```bash
uv sync
```

然后启动服务：

```bash
uv run -m hexagram_mcp_service
```

如果想用 HTTP 方式调试：

```bash
set MCP_TRANSPORT=streamable-http
set MCP_PORT=8000
uv run -m hexagram_mcp_service
```

服务会监听 `http://127.0.0.1:8000`。

## 在阿里云百炼里部署

在「MCP 管理」里选择「创建 MCP 服务」->「使用脚本部署」，然后把安装方式配置为 Python 的 `uvx`。

推荐填写：

- 命令：`uvx`
- 参数：`hexagram-mcp-service`

这样阿里云会从 PyPI 拉取你的包，并直接启动导出的 console script。

如果你想显式指定版本，也可以使用：

- 命令：`uvx`
- 参数：`hexagram-mcp-service==0.1.2`

默认情况下，这个服务使用 `stdio` 作为脚本部署模式；如果你要本地调试 HTTP 模式，可以设置环境变量 `MCP_TRANSPORT=streamable-http`。

可选的环境变量：

- `MCP_HOST`：HTTP 绑定地址，默认 `0.0.0.0`
- `MCP_PORT`：HTTP 端口，默认 `8000`
- `MCP_STREAMABLE_HTTP_PATH`：HTTP 路径，默认 `/mcp`
- `MCP_JSON_RESPONSE`：是否返回 JSON，默认 `true`
- `MCP_STATELESS_HTTP`：是否启用无状态 HTTP，默认 `true`

## 可用能力

- `hexagram()`：按当前时间返回卦象名称
- `health()`：返回健康状态和运行时间
- `service://info`：服务元数据资源
- `deployment_checklist(region)`：部署检查清单提示词

## 阿里云控制台填写建议

如果控制台要求填写服务描述，可以写成：

> 一个可通过 PyPI 发布并使用 uvx 部署的 MCP 服务，提供基础工具、资源和部署检查提示词。
