AI Host
  │  Bearer Token
  ▼
POST /mcp
  │  Streamable HTTP（无会话）
  ▼
McpServer
  ├─ calculate_bazi_chart ── shunshi-bazi-core
  ├─ get_daily_almanac ───── shunshi-bazi-core / tyme4ts
  └─ draw_tarot_reading ──── 78 张静态牌组 + crypto.randomInt

pnpm install
$env:MCP_API_KEY="replace-with-a-long-random-token"
pnpm dev

Copy-Item .env.example .env
docker compose up --build

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "example-host", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("http://127.0.0.1:3100/mcp"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${process.env.MCP_API_KEY}`,
      },
    },
  },
);

await client.connect(transport);
const tools = await client.listTools();
console.log(tools.tools.map((tool) => tool.name));
await transport.close();

pnpm check

src/
├─ index.ts                         # 进程启动与优雅关闭
├─ app.ts                           # HTTP 路由与无会话 MCP transport
├─ config.ts                        # 环境变量解析
├─ http/
│  └─ auth.ts                       # Bearer Token 校验
├─ server/
│  └─ create-fortune-server.ts      # 每个请求创建独立 McpServer
├─ tools/
│  ├─ register-bazi-tool.ts
│  ├─ register-almanac-tool.ts
│  ├─ register-tarot-tool.ts
│  └─ tool-result.ts
└─ domain/
   ├─ date.ts
   └─ tarot/
      ├─ cards.ts                   # 完整 78 张牌数据
      └─ draw.ts                    # Fisher–Yates 与正逆位抽取