Twitter MCP 服务器

用于 Twitter API 集成的模型上下文协议服务器实现。

设置

克隆存储库
安装依赖项： npm install
将.env.example复制到.env并填写您的 Twitter API 凭据
构建项目： npm run build
启动服务器： npm start

Related MCP server: MCP-Twikit

环境变量

.env中所需的 Twitter API 凭据：

X_API_KEY=your_api_key
X_API_SECRET=your_api_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret

可用工具

推文操作

postTweet ：发布新推文
```
{
  "text": "Your tweet text here"
}
```

postTweetWithMedia ：发布带有媒体附件的推文

{
  "text": "Your tweet text",
  "mediaPath": "path/to/media/file",
  "mediaType": "image/jpeg|image/png|image/gif|video/mp4",
  "altText": "Optional alt text for accessibility"
}

getTweetById ：通过 ID 获取特定推文

{
  "tweetId": "tweet_id",
  "tweetFields": ["created_at", "public_metrics"]
}

replyToTweet ：回复现有推文

{
  "tweetId": "tweet_id",
  "text": "Your reply text"
}

deleteTweet ：删除推文
```
{
  "tweetId": "tweet_id"
}
```

搜索与分析

searchTweets ：搜索推文

{
  "query": "search query",
  "maxResults": 10,
  "tweetFields": ["created_at", "public_metrics"]
}

getHashtagAnalytics ：获取主题标签的分析数据

{
  "hashtag": "hashtag",
  "startTime": "ISO-8601 date",
  "endTime": "ISO-8601 date"
}

用户操作

getUserInfo ：获取用户信息

{
  "username": "twitter_username",
  "fields": ["description", "public_metrics"]
}

getUserTimeline ：获取用户的推文

{
  "username": "twitter_username",
  "maxResults": 10,
  "tweetFields": ["created_at", "public_metrics"]
}

getFollowers ：获取用户的关注者

{
  "username": "twitter_username",
  "maxResults": 100,
  "userFields": ["description", "public_metrics"]
}

getFollowing ：获取用户关注的帐户

{
  "username": "twitter_username",
  "maxResults": 100,
  "userFields": ["description", "public_metrics"]
}

订婚

likeTweet ：喜欢一条推文
```
{
  "tweetId": "tweet_id"
}
```
unlikeTweet ：与推文不同
```
{
  "tweetId": "tweet_id"
}
```
retweet ：转发一条推文
```
{
  "tweetId": "tweet_id"
}
```
undoRetweet ：撤消转发
```
{
  "tweetId": "tweet_id"
}
```

getRetweets ：获取转发推文的用户

{
  "tweetId": "tweet_id",
  "maxResults": 100,
  "userFields": ["description", "public_metrics"]
}

getLikedTweets ：获取用户喜欢的推文

{
  "userId": "user_id",
  "maxResults": 100,
  "tweetFields": ["created_at", "public_metrics"]
}

列表管理

createList ：创建新列表

{
  "name": "List name",
  "description": "List description",
  "isPrivate": false
}

addUserToList ：将用户添加到列表

{
  "listId": "list_id",
  "username": "twitter_username"
}

removeUserFromList ：从列表中删除用户

{
  "listId": "list_id",
  "username": "twitter_username"
}

getListMembers ：获取列表成员

{
  "listId": "list_id",
  "maxResults": 100,
  "userFields": ["description", "public_metrics"]
}

错误处理

所有工具都返回标准化的错误响应：

缺少参数： Missing required parameter: parameter_name
API 错误：来自 Twitter API 的错误消息
未找到错误：针对资源的适当“未找到”消息

响应格式

所有成功的响应都遵循以下格式：

{
  "content": [
    {
      "type": "text",
      "text": "Operation result message"
    }
  ]
}

发展

构建： npm run build
开始： npm start
观察模式： npm run dev

Here's a comprehensive status report of all Twitter tools:

## Working Tools (✓)

1. postTweet

状态：运行正常响应：返回推文ID 最新测试：成功


2. getTweetById

状态：运行正常响应：返回完整的推文数据最新测试：成功


3. likeTweet & unlikeTweet

状态：运行正常响应：确认操作最新测试：成功


4. retweet & undoRetweet

状态：运行正常响应：确认操作最新测试：成功


5. replyToTweet

状态：运行正常响应：返回回复推文ID 最新测试：成功


6. getUserInfo

状态：运行正常响应：完成用户资料数据最新测试：成功


7. followUser & unfollowUser

状态：运行正常响应：确认操作最新测试：成功


8. createList

状态：运行正常响应：确认列表创建最新测试：成功


9. getUserLists

状态：运行正常响应：返回拥有者和成员列表最新测试：成功


## Tools with Issues (⚠️)

1. getUserTimeline

状态：错误 400 错误：请求参数无效需要修复：参数验证


2. searchTweets

状态：错误 400 错误：请求参数无效需要修复：查询参数格式


3. getLikedTweets

状态：错误 400 错误：请求参数无效需要修复：参数验证


## Missing Tools (❌)
- getHomeTimeline (not found in available tools)
- getFollowers (not available)
- getFollowing (not available)
- getHashtagAnalytics (not available)

## Priority Fixes Needed

1. Parameter Validation:
```typescript
// Implement for getUserTimeline, searchTweets, getLikedTweets
interface TwitterParamValidator {
  validateTimelineParams(params: any): boolean;
  validateSearchParams(params: any): boolean;
  validateLikedTweetsParams(params: any): boolean;
}

错误处理：

// Enhance error handling for 400 errors
interface TwitterErrorHandler {
  handle400Error(endpoint: string, params: any): void;
  logErrorDetails(error: any): void;
  suggestParameterFixes(params: any): string[];
}