Typefully MCP Server

Typefully MCP サーバー

Typefully API との連携を提供する Model Context Protocol（MCP）サーバーです。AI アシスタントが Typefully で下書きを作成、管理できます。

機能

• 下書きの作成（以下を完全にサポート）：
  • 複数のツイートからなるスレッド（区切り文字として改行を4つ使用）
  • スレッドへの自動分割
  • 予約投稿（日時指定または次の空き枠）
  • AutoRT および AutoPlug 機能
  • 共有 URL
• 予約済みの下書きの取得（任意のフィルタリングに対応）
• 公開済みの下書きの取得（任意のフィルタリングに対応）

インストール

前提条件

• Python 3.10 以降
• API にアクセスできる Typefully アカウント
• Typefully API キー（Typefully の Settings > Integrations から取得してください）

ソースからインストール

1. このリポジトリをクローンします：

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

2. 仮想環境を作成して有効化します：

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. パッケージをインストールします：

pip install -e .

設定

API キーの管理

このサーバーは、macOS キーチェーンを使用した安全な API キーの保存に対応しています。次の2つの方法があります。

方法1：macOS キーチェーン（推奨）🔐

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（任意）：true の場合、返されるペイロードに share_url が含まれます
• schedule_date（任意）：ISO 形式の日付（例：「2024-01-15T10:30:00Z」）または「next-free-slot」
• auto_retweet_enabled（任意）：この投稿で AutoRT を有効にします
• auto_plug_enabled（任意）：この投稿で AutoPlug を有効にします

例：

Create a draft with content "Hello from MCP! This is my first automated tweet." and schedule it for next free slot

get_scheduled_drafts

Typefully から最近予約された下書きを取得します。

パラメーター：

• content_filter（任意）：下書きを「tweets」または「threads」のみに絞り込みます

例：

Get my scheduled drafts that are threads only

get_published_drafts

Typefully から最近公開された下書きを取得します。

パラメーター：

• content_filter（任意）：下書きを「tweets」または「threads」のみに絞り込みます

例：

Show me all my recently published tweets

テスト

サーバーの機能を確認するためのテストスクリプトが含まれています：

# Make sure your virtual environment is activated
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Test the API connectivity (requires API key configured)
python test_read_api.py

開発

プロジェクト構成

typefully-mcp-server/
├── src/
│   └── typefully_mcp_server/
│       ├── __init__.py
│       ├── server.py      # Main MCP server implementation
│       ├── client.py      # Typefully API client
│       ├── keychain.py    # Secure keychain integration
│       └── types.py       # Type definitions
├── pyproject.toml
├── requirements.txt
├── README.md
└── test_read_api.py       # Test script

テストの実行

# Make sure your virtual environment is activated
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

API リファレンス

この MCP サーバーは、Typefully APIの一部を実装しています。API エンドポイントやオプションの詳細については、公式ドキュメントを参照してください。

ライセンス

MIT ライセンス

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。