Typefully MCP 服务器

这是一个模型上下文协议（MCP）服务器，提供与 Typefully API 的集成，允许 AI 助手在 Typefully 上创建和管理草稿。

特性

• 创建草稿，完全支持以下功能：
  • 多条推文线程（使用4个换行符作为分隔符）
  • 自动线程化
  • 计划（特定日期/时间或下一个空闲时段）
  • 自动转推和自动插件功能
  • 分享 URL
• 获取已计划的草稿，可选过滤
• 获取已发布的草稿，可选过滤

安装

先决条件

• Python 3.10 或更高版本
• 带有 API 访问权限的 Typefully 账户
• 您的 Typefully API 密钥（从 Typefully 设置 > 集成中获取）

从源代码安装

1. 克隆此仓库：

git clone <repository-url>
cd typefully-mcp-server

2. 创建并激活虚拟环境：

python3 -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

3. 安装包：

pip install -e .

配置

API 密钥管理

此服务器支持使用 macOS Keychain 进行安全的 API 密钥存储。您有两个选项：

选项 1：macOS Keychain（推荐） 🔐

将您的 API 密钥安全地存储在 macOS 系统密钥链中：

• 服务：typefully-mcp-server
• 账户：api_key
• 密码：您的 Typefully API 密钥

有关详细的密钥链设置说明，请参阅 CURSOR_SETUP.md。

选项 2：环境变量

您可以将 API 密钥设置为环境变量，或者直接包含在您的 MCP 配置中。

注意：环境变量优先于密钥链存储以确保兼容性。

MCP 配置

有关详细的 MCP 客户端设置说明（如 Cursor、Claude Desktop 等），请参阅 CURSOR_SETUP.md。

基本 MCP 配置示例：

{
  "mcpServers": {
    "typefully": {
      "command": "/path/to/your/typefully-mcp-server/venv/bin/python",
      "args": ["-m", "typefully_mcp_server.server"],
      "cwd": "/path/to/your/typefully-mcp-server"
    }
  }
}

使用

配置完成后，MCP 服务器提供了以下工具：

create_draft

在 Typefully 中创建新的草稿。

参数：

• content（必需）：草稿的内容。使用4个连续的换行符来分割成多条推文。
• threadify（可选）：自动将内容分割成多条推文
• share（可选）：如果为真，则返回的负载将包括一个分享 URL
• schedule_date（可选）：ISO 格式的日期（例如，“2024-01-15T10:30:00Z”）或“next-free-slot”
• auto_retweet_enabled（可选）：为此帖子启用自动转推
• auto_plug_enabled（可选）：为此帖子启用自动插件

示例：

创建一个内容为“Hello from MCP! This is my first automated tweet.”的草稿，并将其安排到下一个空闲时段

get_scheduled_drafts

从 Typefully 获取最近已计划的草稿。

参数：

• content_filter（可选）：仅包括“tweets”或“threads”的草稿

示例：

获取我仅有的线程类型的已计划草稿

get_published_drafts

从 Typefully 获取最近已发布的草稿。

参数：

• content_filter（可选）：仅包括“tweets”或“threads”的草稿

示例：

显示我最近发布的所有推文

测试

包含了一个测试脚本来验证服务器的功能：

# 确保您的虚拟环境已激活
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 测试 API 连接（需要配置 API 密钥）
python test_read_api.py

开发

项目结构

typefully-mcp-server/
├── src/
│   └── typefully_mcp_server/
│       ├── __init__.py
│       ├── server.py      # 主 MCP 服务器实现
│       ├── client.py      # Typefully API 客户端
│       ├── keychain.py    # 安全密钥链集成
│       └── types.py       # 类型定义
├── pyproject.toml
├── requirements.txt
├── README.md
└── test_read_api.py       # 测试脚本

运行测试

# 确保您的虚拟环境已激活
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 安装开发依赖项
pip install -e ".[dev]"

# 运行测试
pytest

API 参考

此 MCP 服务器实现了 Typefully API 的一部分。有关 API 端点和选项的更多详细信息，请参阅官方文档。

许可证

MIT 许可证

贡献

欢迎贡献！请随时提交拉取请求。