Postscript MCP 服务器

一个用于与 Postscript SMS 营销平台 API 交互的 MCP 服务器。

## 设置

1. 安装依赖:
   ```
   npm install
   ```

2. 配置您的 API 密钥:
   - 在根目录下创建一个 `.env` 文件
   - 添加您的 Postscript API 密钥: `POSTSCRIPT_API_KEY=your_api_key_here`

3. 运行服务器:
   ```
   npm run dev
   ```

4. 使用 MCP Inspector 测试:
   ```
   npm run inspect
   ```

## 功能

此 MCP 服务器提供对以下 Postscript API 功能的访问：

- **商店 (Shops)**: 获取有关您的 Postscript 商店的信息
- **订阅者 (Subscribers)**: 管理 SMS 订阅者（创建、更新、检索）
- **活动 (Campaigns)**: 创建和检索 SMS 活动
- **消息 (Messages)**: 向订阅者发送直接消息
- **关键词 (Keywords)**: 检索 SMS 关键词

## 可用工具

- `get_shops`: 获取所有 Postscript 商店
- `get_shop`: 通过 ID 获取特定商店
- `get_subscribers`: 获取商店的订阅者
- `get_subscriber`: 通过 ID 获取特定订阅者
- `create_subscriber`: 创建新的订阅者
- `update_subscriber`: 更新现有订阅者
- `get_campaigns`: 获取商店的活动
- `create_campaign`: 创建新的活动
- `send_message`: 向订阅者发送直接消息
- `get_keywords`: 获取商店的关键词

## 可用资源

- `postscript://shops`: 列出所有商店
- `postscript://shops/{shopId}`: 获取特定商店
- `postscript://shops/{shopId}/subscribers`: 列出商店的订阅者
- `postscript://shops/{shopId}/subscribers/{subscriberId}`: 获取特定订阅者
- `postscript://shops/{shopId}/campaigns`: 列出商店的活动

## API 文档

有关 Postscript API 的更多信息，请参阅：
- [入门指南](https://developers.postscript.io/docs/getting-started)
- [API 参考](https://developers.postscript.io/reference/new-object-identifiers)