이 MCP 서버는 클라이언트가 트위터와 상호작용할 수 있게 하여 트윗을 게시하고 트위터를 검색할 수 있게 합니다.

퀵 스타트

1. 트위터 개발자 계정을 만들고 Twitter 개발자 포털에서 API 키를 받으세요

2. 이 구성을 Claude Desktop 설정 파일에 추가하세요:

윈도우: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. 클로드 데스크톱 재시작

그게 전부입니다! 클로드는 이제 두 가지 도구를 통해 트위터와 상호작용할 수 있습니다:

• 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