X(트위터) MCP 서버

이 MCP 서버를 통해 클라이언트는 X(이전의 Twitter)와 상호 작용하여 트윗 게시, 콘텐츠 검색, 계정 관리, 목록 구성을 포함한 포괄적인 플랫폼 운영이 가능합니다.

빠른 시작

X Developer 계정을 만들고 X Developer Portal 에서 API 키를 받으세요.
환경 변수에 필요한 모든 API 키를 설정하세요.
이 저장소를 복제하세요: git clone https://github.com/Dishant27/twitter-mcp.git
종속성 설치: npm install
서버를 실행합니다:

환경 변수를 사용하면:

지엑스피1

.env 파일 사용:

# Create a .env file with your X API keys
echo "TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret" > .env

# Start the server
npm start

Claude와 같은 MCP 클라이언트와 함께 사용하세요.

클로드 구성

이 서버를 Claude와 함께 사용하려면 MCP 구성을 설정해야 합니다. 구성 구조의 예는 다음과 같습니다.

{
  "name": "x",
  "display_name": "X",
  "description": "X MCP allows Claude to interact with X (formerly Twitter)",
  "path": "path/to/twitter-mcp/dist/index.js",
  "startup": {
    "env": {
      "TWITTER_API_KEY": "your_api_key",
      "TWITTER_API_SECRET": "your_api_secret",
      "TWITTER_ACCESS_TOKEN": "your_access_token",
      "TWITTER_ACCESS_TOKEN_SECRET": "your_access_token_secret"
    }
  },
  "transport": "stdio"
}

이 구성을 Claude MCP 구성 디렉토리에 저장하세요. 일반적으로 다음 위치에 있습니다.

윈도우: %APPDATA%\AnthropicClaude\mcp-servers
macOS: ~/Library/Application Support/AnthropicClaude/mcp-servers
리눅스: ~/.config/AnthropicClaude/mcp-servers

특징

포스트 운영

게시물 내용 (최대 280자)
사용자 정의 가능한 결과 수를 사용하여 쿼리로 게시물 검색

계정 관리

모든 사용자 또는 인증된 계정에 대한 프로필 정보를 가져옵니다.
프로필 세부 정보(이름, 자기소개, 위치, 웹사이트 URL) 업데이트
사용자 팔로우 및 팔로우 취소
모든 사용자 또는 인증된 계정에 대한 팔로워 목록
사용자가 팔로우하는 계정 나열

목록 관리

새로운 목록(공개 또는 비공개)을 만듭니다.
특정 목록에 대한 정보 얻기
인증된 사용자가 소유한 모든 목록을 검색합니다.

사용 가능한 MCP 도구

도구 이름	설명
`post_tweet`	X에 새 콘텐츠 게시
`search_tweets`	X에서 콘텐츠 검색
`get_profile`	사용자 또는 인증된 계정에 대한 프로필 정보를 가져옵니다.
`update_profile`	인증된 사용자 프로필 업데이트
`follow_user`	사용자를 팔로우하세요
`unfollow_user`	사용자 팔로우 취소
`list_followers`	사용자 또는 인증된 계정의 팔로워 목록
`list_following`	사용자 또는 인증된 계정이 팔로우하는 계정을 나열합니다.
`create_list`	새 목록을 만듭니다
`get_list_info`	목록에 대한 정보 얻기
`get_user_lists`	인증된 사용자가 소유한 모든 목록을 가져옵니다.

요구 사항

Node.js 18.x 이상
API 키가 있는 X 개발자 계정
API v1 및 v2 액세스

환경 변수

변하기 쉬운	설명
`TWITTER_API_KEY`	귀하의 API 키
`TWITTER_API_SECRET`	귀하의 API 비밀번호
`TWITTER_ACCESS_TOKEN`	귀하의 액세스 토큰
`TWITTER_ACCESS_TOKEN_SECRET`	액세스 토큰 비밀번호

저장소 구조

twitter-mcp/
├── .github/
│   └── workflows/
│       ├── publish.yml
│       └── release.yml
├── code/
│   ├── account_management.py  # Sample Python code for account management
│   ├── post_tweet.py          # Sample Python code for posting content
│   └── retrieve_tweets.py     # Sample Python code for retrieving content
├── src/
│   ├── index.ts        # Main entry point
│   ├── twitter-api.ts  # X API client
│   ├── formatter.ts    # Response formatter
│   └── types.ts        # Type definitions
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── package.json
├── README.md
└── tsconfig.json

특허

MIT