このMCPサーバーにより、クライアントはTwitterとやり取りでき、ツイートの投稿や検索が可能になります。

クイックスタート

1. Twitter開発者アカウントを作成し、Twitter開発者ポータルからAPIキーを取得する

2. この設定をClaude Desktopの設定ファイルに追加します:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Claude Desktop の再起動

それだけです!クロードは今、2つのツールを使ってTwitterとやり取りできます。

• post_tweet: 新しいツイートを投稿する
• search_tweets: ツイート検索

使用例

クロードに聞いてみてください:

• 「『Claudeからこんにちは!』とツイートしてくれませんか?」
• 「Claude AIに関するツイートを検索できますか?」

トラブルシューティング

ログは以下で入手可能です:

• Windows: %APPDATA%\Claude\logs\mcp-server-twitter.log
• macOS: ~/Library/Logs/Claude/mcp-server-twitter.log

開発

貢献したい場合やソースから逃げたい場合:

1. リポジトリのクローン:

2. 依存関係のインストール:

3. ビルド:

4. 走る:

評価を実行中

evalsパッケージはmcpクライアントを読み込み、index.tsファイルを実行するため、テスト間に再構築する必要がありません。

Twitter MCP Server

This MCP server allows Clients to interact with Twitter, enabling posting tweets, searching Twitter and reading your home timeline.

Quick Start

1. Create a Twitter Developer account and get your API keys from Twitter Developer Portal

2. Add this configuration to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "twitter-mcp": {
      "command": "npx",
      "args": ["-y", "@enescinar/twitter-mcp"],
      "env": {
        "API_KEY": "your_api_key_here",
        "API_SECRET_KEY": "your_api_secret_key_here",
        "ACCESS_TOKEN": "your_access_token_here",
        "ACCESS_TOKEN_SECRET": "your_access_token_secret_here"
      }
    }
  }
}

3. Restart Claude Desktop

That’s it! Claude can now interact with Twitter through three tools:

• post_tweet: Post a new tweet, optionally as a reply (reply_to_tweet_id) or with up to 4 images (media_paths: local JPG, PNG, GIF or WEBP files)
• search_tweets: Search for tweets
• get_home_timeline: Get recent tweets from accounts you follow

get_home_timeline

Returns your reverse-chronological home timeline (tweets from you and the accounts you follow), newest first. All parameters are optional:

• count: number of tweets to return (1-100)
• since_days: only return tweets from the last N days, e.g. 1, 3 or 7 (max 30)
• start_time: only return tweets created after this ISO 8601 UTC timestamp, e.g. 2024-01-01T00:00:00Z

Use either since_days or start_time, not both.

Note: The home timeline endpoint (GET /2/users/:id/timelines/reverse_chronological) is not available on the Free X API tier. You need a paid tier (Basic or higher); on the Free tier this tool returns a Twitter API error.

Example Usage

Try asking Claude:

• “Can you post a tweet saying ‘Hello from Claude!’”
• “Can you post a tweet saying ‘New logo!’ with the image /Users/me/Pictures/logo.png”
• “Can you search for tweets about Claude AI?”
• “What have the accounts I follow posted in the last 3 days?”

Troubleshooting

Logs can be found at:

• Windows: %APPDATA%\Claude\logs\mcp-server-twitter.log
• macOS: ~/Library/Logs/Claude/mcp-server-twitter.log

Development

If you want to contribute or run from source:

1. Clone the repository:

git clone https://github.com/EnesCinr/twitter-mcp.git
cd twitter-mcp