semvec/pypi-packages huggingface dataset:
invideo-ai-mcp 0.0.5
The invideo-ai MCP server enables any MCP Client like Claude Desktop or Agents to use the invideo-ai API to generate videos.
Requires Python: >=3.13
Keywords: invideo-ai, mcp, claude, ai, video

# InVideo AI MCP Server

![Invideo AI Logo](invideo-ai.png)

The InVideo AI MCP server enables any MCP Client like Claude Desktop or Agents to use the InVideo AI API to generate AI videos.

**Note**: This project is in early development. While we welcome community feedback and contributions, please be aware that official support is limited.

## Installation

### Prerequisites

- Python 3.13 or higher

### Installing uv

`uv` is a fast Python package installer and resolver that we recommend for installing this package.

**macOS or Linux**:

```bash
# Install with the official installer script
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via Homebrew (macOS)
brew install uv
```

**Windows**:

```powershell
# Install with the official installer script in PowerShell
irm https://astral.sh/uv/install.ps1 | iex

# Or via Scoop
scoop install uv
```

For other installation methods, see the [uv documentation](https://github.com/astral-sh/uv).

## Usage

### Quickstart with Claude Desktop

1. Install uv package manager (see Installing uv section above).
2. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

```json
{
  "mcpServers": {
    "InVideoAI": {
      "command": "uvx",
      "args": ["invideo-ai-mcp"]
    }
  }
}
```

If you're using Windows, you'll need to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu at the top left and select "Enable Developer Mode".

## Available MCP Tools

The server provides the following tools to Claude:

- **generate_content_ideas**: Generate content ideas for a specific platform with topic, vibe, and target audience suggestions.
- **generate_script**: Generate a video script based on topic, vibe, and target audience.
- **generate_video_from_script**: Generate a video using a script and additional context (topic, vibe, target audience).

## Roadmap

- [ ] Video editing capabilities
mcp-twitterio 0.1.0
Twitter API的MCP服务，基于twitterapi.io，使用studio模式进行通信
Requires Python: >=3.12

# Twitter API MCP服务

这是一个基于Model Context Protocol (MCP)的Twitter API客户端，使用twitterapi.io的API服务来获取Twitter数据。该服务允许AI助手（如Claude）查询Twitter数据，包括用户信息、推文、趋势等。

## 功能

* 获取用户信息和用户关系数据（粉丝、关注）
* 搜索和获取推文，包括用户时间线、列表推文
* 获取推文详情、回复、引用和转发信息
* 高级推文搜索功能

## 环境要求

* Python 3.12或更高版本
* mcp库 >= 1.6.0
* httpx >= 0.28.1
* python-dotenv >= 1.0.0 (可选，用于加载环境变量)

## 安装

1. 确保你已安装必要的依赖：
   ```bash
   pip install "mcp>=1.6.0" "httpx>=0.28.1" "python-dotenv>=1.0.0"
   ```
   或者使用uv：
   ```bash
   uv pip install "mcp>=1.6.0" "httpx>=0.28.1" "python-dotenv>=1.0.0"
   ```

2. 设置Twitter API密钥：
   ```bash
   export TWITTER_API_KEY="your_api_key_here"
   ```
   
   或者创建一个`.env`文件：
   ```
   TWITTER_API_KEY=your_api_key_here
   ```

## 使用方法

### 使用MCP CLI运行服务

```bash
mcp dev main.py
```

这将使用MCP Inspector启动服务，可通过本地网页界面测试其功能。

### 安装到Claude Desktop

要在Claude Desktop中使用此服务：

```bash
mcp install main.py --name "Twitter API"
```

### 直接执行

```bash
python main.py
```

## 可用的工具

### 用户相关工具
1. `get_user_info_by_username` - 根据用户名获取Twitter用户信息
2. `batch_get_users_by_ids` - 批量获取用户信息
3. `get_user_last_tweets` - 获取用户最新的推文
4. `get_user_followers` - 获取用户的粉丝列表
5. `get_user_followings` - 获取用户的关注列表
6. `get_user_mentions` - 获取用户被提及的推文

### 推文相关工具
7. `get_tweets_by_ids` - 通过推文ID获取推文
8. `get_tweet_replies` - 获取推文的回复
9. `get_tweet_quotations` - 获取引用推文的推文
10. `get_tweet_retweeters` - 获取转发推文的用户
11. `get_list_tweets` - 获取列表中的推文
12. `advanced_search_tweets` - 高级搜索推文

## 示例使用场景

使用Claude与此MCP服务的交互示例：

1. 获取用户信息：
   "请获取Twitter用户'elonmusk'的个人资料信息。"

2. 搜索推文：
   "请通过高级搜索找到关于'人工智能'的最新推文，限制结果为5条。"

3. 查看用户推文：
   "显示用户'elonmusk'的最新3条推文。"

4. 获取推文回复：
   "获取ID为'1234567890'的推文的所有回复。"

5. 了解推文引用：
   "查看有哪些用户引用了ID为'1234567890'的推文。"

## 注意事项

* 你需要一个有效的twitterapi.io API密钥才能使用此服务
* 某些API调用可能受到twitterapi.io的速率限制
* 确保遵守Twitter的服务条款和API使用政策

## 开发与测试

项目包含examples目录中的客户端示例代码，可用于了解如何从Python程序中调用此MCP服务。
tests目录包含基本的单元测试，可确保服务核心功能正常工作。