Twitter Mcp Js

by yolleygit

249 downloads

Not rated

GitHub

Other

About

A complete Twitter API MCP server implementation based on the API endpoints provided by twitterapi.io.

Details

Author: yolleygit
Downloads: 249
Categories: Other

- 32 tools covering user, tweet, community, trend, and action endpoints
- Get user info, tweets, followers, followings, and mentions
- Batch retrieve user data and check follow relationships
- Search tweets with advanced queries
- Create, delete, retweet, like, and unlike tweets
- Send direct messages and manage follows
- Community management: create, delete, join, leave, get info/members
- Fetch trending topics and account info

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Twitter Mcp Js

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

From the repository

After cloning the repository and installing dependencies, configure your TWITTER_API_KEY in a .env file. Start the server with npm run dev (development) or npm start (production). Integrate the server with an MCP client using either a local Node.js command or the npx command, both requiring the API key as an environment variable.

`twitter_get_user_info`

Get user profile information by username (获取用户资料信息)

`twitter_batch_get_users`

Batch get user info by user IDs (批量获取用户信息)

`twitter_get_user_tweets`

Get user's recent tweets (获取用户最近推文)

`twitter_get_user_followers`

Get user's followers (获取用户粉丝)

`twitter_get_user_followings`

Get user's followings (获取用户关注列表)

`twitter_get_user_mentions`

Get tweets mentioning the user (获取提及用户的推文)

`twitter_check_follow_relationship`

Check if one user follows another (检查关注关系)

`twitter_search_users`

Search users by keyword (按关键字搜索用户)

`twitter_get_tweets`

Get tweets by IDs (按ID获取推文)

`twitter_get_tweet_replies`

Get replies to a tweet (获取推文回复)

`twitter_get_tweet_quotes`

Get quote tweets of a tweet (获取引用推文)

`twitter_get_tweet_retweeters`

Get users who retweeted a tweet (获取转推用户)

`twitter_get_tweet_thread`

Get tweet thread context (获取推文线程上下文)

`twitter_get_article`

Get long-form tweet/article (获取长推文/文章)

`twitter_advanced_search`

Advanced search for tweets (高级搜索推文)

`twitter_get_community_info`

Get community information (获取社区信息)

`twitter_get_community_members`

Get community members (获取社区成员)

`twitter_get_community_moderators`

Get community moderators (获取社区管理员)

`twitter_get_community_tweets`

Get community tweets (获取社区推文)

`twitter_get_trends`

Get trending topics for a location (获取地区热门趋势)

`twitter_get_my_info`

Get my account information (获取我的账户信息)

`twitter_login`

`twitter_create_tweet`

Create a new tweet (创建新推文)

`twitter_send_dm`

Send direct message (发送私信)

`twitter_retweet`

Retweet a tweet (转发推文)

`twitter_delete_tweet`

Delete a tweet (删除推文)

`twitter_follow_user`

Follow a user (关注用户)

`twitter_unfollow_user`

Unfollow a user (取消关注用户)

`twitter_like_tweet`

Like a tweet (点赞推文)

`twitter_unlike_tweet`

Unlike a tweet (取消点赞推文)

`twitter_create_community`

Create a new community (创建社区)

`twitter_delete_community`

Delete a community (删除社区)

`twitter_join_community`

Join a community (加入社区)

`twitter_leave_community`

Leave a community (退出社区)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "twitter mcp js": {
            "twitter-mcp-server": {
                "command": "npx",
                "args": [
                    "twitter-mcp-js"
                ],
                "env": {
                    "TWITTER_API_KEY": "your_api_key_here"
                },
                "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
            }
        }
    }
}

McpServers

{
    "twitter-mcp-server": {
        "command": "npx",
        "args": [
            "twitter-mcp-js"
        ],
        "env": {
            "TWITTER_API_KEY": "your_api_key_here"
        },
        "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
    }
}

Twitter MCP Server

一个完整的Twitter API MCP服务器，基于twitterapi.io提供的API端点实现。

功能特性 / Features

用户端点 / User Endpoints

- ✅ 获取用户信息 / Get user info - ✅ 批量获取用户信息 / Batch get users - ✅ 获取用户推文 / Get user tweets - ✅ 获取用户粉丝 / Get user followers - ✅ 获取用户关注列表 / Get user followings - ✅ 获取用户提及 / Get user mentions - ✅ 检查关注关系 / Check follow relationship - ✅ 搜索用户 / Search users

推文端点 / Tweet Endpoints

- ✅ 按ID获取推文 / Get tweets by IDs - ✅ 获取推文回复 / Get tweet replies - ✅ 获取引用推文 / Get tweet quotes - ✅ 获取转推用户 / Get tweet retweeters - ✅ 获取推文线程 / Get tweet thread - ✅ 获取长推文/文章 / Get articles - ✅ 高级搜索 / Advanced search

社区端点 / Community Endpoints

- ✅ 获取社区信息 / Get community info - ✅ 获取社区成员 / Get community members - ✅ 获取社区管理员 / Get community moderators - ✅ 获取社区推文 / Get community tweets

趋势端点 / Trend Endpoints

- ✅ 获取地区热门趋势 / Get trending topics

账户信息 / Account Info

- ✅ 获取我的账户信息 / Get my account info

操作端点 (V2) / Action Endpoints (V2)

- ✅ 登录 / Login - ✅ 创建推文 / Create tweet - ✅ 发送私信 / Send DM - ✅ 转发推文 / Retweet - ✅ 删除推文 / Delete tweet - ✅ 关注用户 / Follow user - ✅ 取消关注 / Unfollow user - ✅ 点赞推文 / Like tweet - ✅ 取消点赞 / Unlike tweet - ✅ 创建社区 / Create community - ✅ 删除社区 / Delete community - ✅ 加入社区 / Join community - ✅ 退出社区 / Leave community

安装 / Installation

1. 克隆项目 / Clone the repository:

git clone <repository-url>

cd twitter-mcp-js

2. 安装依赖 / Install dependencies:

npm install

3. 配置环境变量 / Configure environment variables:

cp .env.example .env

编辑 .env 文件，添加你的 Twitter API 密钥


Edit .env file and add your Twitter API key

配置 / Configuration

在 .env 文件中配置以下变量 / Configure the following variables in .env:

# Twitter API Configuration
TWITTER_API_KEY=your_api_key_here
Server Configuration
PORT=3000
NODE_ENV=development
LOG_LEVEL=info

使用方法 / Usage

启动服务器 / Start the server

# 开发模式 / Development mode
npm run dev
生产模式 / Production mode
npm start

MCP客户端配置 / MCP Client Configuration

本地开发配置 / Local Development Configuration

适用于本地开发和调试 / For local development and debugging:

{
  "$schema": "https://github.com/modelcontextprotocol/specification/blob/main/schema/mcp_config_schema.json",
  "description": "Twitter MCP Server Configuration for Local Development",
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "node",
      "args": ["/path/to/twitter-mcp-js/src/index.js"],
      "env": {
        "TWITTER_API_KEY": "your_twitter_api_key_here"
      },
      "description": "Complete Twitter API integration with 32 tools for social media automation",
      "capabilities": {
        "tools": true
      }
    }
  }
}

NPX远程配置 / NPX Remote Configuration

适用于快速部署和测试 / For quick deployment and testing:

{
  "$schema": "https://github.com/modelcontextprotocol/specification/blob/main/schema/mcp_config_schema.json",
  "description": "Twitter MCP Server Configuration using NPX",
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "npx",
      "args": ["twitter-mcp-js"],
      "env": {
        "TWITTER_API_KEY": "your_api_key_here"
      },
      "description": "Twitter MCP Server - Complete Twitter API integration with 32 tools for social media automation and analytics"
    }
  }
}

API使用示例 / API Usage Examples

获取用户信息 / Get User Info

// 通过MCP调用
{
  "tool": "twitter_get_user_info",
  "arguments": {
    "userName": "elonmusk"
  }
}

搜索推文 / Search Tweets

{
  "tool": "twitter_advanced_search",
  "arguments": {
    "query": "AI technology",
    "queryType": "Latest"
  }
}

创建推文 / Create Tweet

{
  "tool": "twitter_create_tweet",
  "arguments": {
    "login_cookies": "your_login_cookie",
    "tweet_text": "Hello from MCP!"
  }
}

项目结构 / Project Structure

twitter-mcp-js/
├── src/
│   ├── index.js          # MCP服务器主文件 / Main MCP server
│   ├── twitter-api.js    # Twitter API客户端 / Twitter API client
│   ├── tools.js          # 工具定义 / Tool definitions
│   └── health-server.js  # 健康检查服务器 / Health check server
├── .github/
│   └── workflows/
│       └── security.yml  # 安全扫描工作流 / Security scan workflow
├── mcp-config-local.json # 本地开发配置 / Local development config
├── mcp-config-npx.json   # NPX远程配置 / NPX remote config
├── examples.md           # 详细使用示例 / Detailed examples
├── twitterapi_io.md      # API文档参考 / API documentation
├── package.json          # 项目配置 / Project configuration
├── README.md            # 项目文档 / Project documentation
└── LICENSE              # 许可证 / License

错误处理 / Error Handling

服务器包含完整的错误处理机制 / The server includes comprehensive error handling:

- API请求错误 / API request errors
- 参数验证错误 / Parameter validation errors
- 网络连接错误 / Network connection errors
- 认证错误 / Authentication errors

开发指南 / Development Guide

添加新工具 / Adding New Tools

1. 在 src/tools.js 中定义工具schema / Define tool schema in src/tools.js
2. 在 src/twitter-api.js 中实现API方法 / Implement API method in src/twitter-api.js
3. 在 src/index.js 中添加工具处理逻辑 / Add tool handling logic in src/index.js

代码规范 / Code Standards

- 使用ES6+ 语法 / Use ES6+ syntax
- 遵循JSDoc注释规范 / Follow JSDoc comment standards
- 保持代码模块化和可测试性 / Keep code modular and testable

许可证 / License

MIT License

贡献 / Contributing

欢迎提交Issue和Pull Request / Issues and Pull Requests are welcome!

支持 / Support

如有问题，请查看 / For issues, please check:
1. API文档 / API documentation
2. 环境变量配置 / Environment variable configuration
3. 网络连接状态 / Network connection status
4. API密钥有效性 / API key validity

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

twitter_get_user_info

twitter_batch_get_users

twitter_get_user_tweets

twitter_get_user_followers

twitter_get_user_followings

twitter_get_user_mentions

twitter_check_follow_relationship

twitter_search_users

twitter_get_tweets

twitter_get_tweet_replies

twitter_get_tweet_quotes

twitter_get_tweet_retweeters

twitter_get_tweet_thread

twitter_get_article

twitter_advanced_search

twitter_get_community_info

twitter_get_community_members

twitter_get_community_moderators

twitter_get_community_tweets

twitter_get_trends

twitter_get_my_info

twitter_login

twitter_create_tweet

twitter_send_dm

twitter_retweet

twitter_delete_tweet

twitter_follow_user

twitter_unfollow_user

twitter_like_tweet

twitter_unlike_tweet

twitter_create_community

twitter_delete_community

twitter_join_community

twitter_leave_community

Claude Desktop / Cursor

McpServers

Twitter MCP Server

功能特性 / Features

用户端点 / User Endpoints

推文端点 / Tweet Endpoints

社区端点 / Community Endpoints

趋势端点 / Trend Endpoints

账户信息 / Account Info

操作端点 (V2) / Action Endpoints (V2)

安装 / Installation

编辑 .env 文件，添加你的 Twitter API 密钥

Edit .env file and add your Twitter API key

配置 / Configuration

Server Configuration

使用方法 / Usage

启动服务器 / Start the server

生产模式 / Production mode

MCP客户端配置 / MCP Client Configuration

本地开发配置 / Local Development Configuration

NPX远程配置 / NPX Remote Configuration

API使用示例 / API Usage Examples

获取用户信息 / Get User Info

搜索推文 / Search Tweets

创建推文 / Create Tweet

项目结构 / Project Structure

错误处理 / Error Handling

开发指南 / Development Guide

添加新工具 / Adding New Tools

代码规范 / Code Standards

许可证 / License

贡献 / Contributing

支持 / Support

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`twitter_get_user_info`

`twitter_batch_get_users`

`twitter_get_user_tweets`

`twitter_get_user_followers`

`twitter_get_user_followings`

`twitter_get_user_mentions`

`twitter_check_follow_relationship`

`twitter_search_users`

`twitter_get_tweets`

`twitter_get_tweet_replies`

`twitter_get_tweet_quotes`

`twitter_get_tweet_retweeters`

`twitter_get_tweet_thread`

`twitter_get_article`

`twitter_advanced_search`

`twitter_get_community_info`

`twitter_get_community_members`

`twitter_get_community_moderators`

`twitter_get_community_tweets`

`twitter_get_trends`

`twitter_get_my_info`

`twitter_login`

`twitter_create_tweet`

`twitter_send_dm`

`twitter_retweet`

`twitter_delete_tweet`

`twitter_follow_user`

`twitter_unfollow_user`

`twitter_like_tweet`

`twitter_unlike_tweet`

`twitter_create_community`

`twitter_delete_community`

`twitter_join_community`

`twitter_leave_community`