# mcp_server_collection

**Repository Path**: bhr123456/mcp_server_collection

## Basic Information

- **Project Name**: mcp_server_collection
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tavily MCP Server

这是一个基于Tavily API的MCP搜索服务，提供网页搜索、问答搜索和新闻搜索功能。该服务支持智能体调用，并可以通过HTTP API进行访问。

## 功能特点

- 支持三种搜索模式：
  - 网页搜索（Web Search）
  - 问答搜索（Answer Search）
  - 新闻搜索（News Search）
- 支持多种响应格式（文本、JSON、Markdown）
- 提供域名过滤功能（包含/排除特定域名）
- 内置结果缓存机制
- 完整的错误处理
- API密钥认证
- 支持CORS

## 安装

```bash
pip install tavily-mcp-server
```

## 环境配置

创建`.env`文件并添加以下内容：

```env
TAVILY_API_KEY=your_tavily_api_key
MCP_API_KEY=your_mcp_api_key
```

## 使用方式

### 1. 命令行启动

```bash
# 基本启动
tavily-mcp start

# 自定义配置启动
tavily-mcp start --host 0.0.0.0 --port 8083 --log-level info

# 查看版本
tavily-mcp version
```

### 2. 在UVX中配置

```json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "uvx",
      "args": ["tavily-mcp-server"],
      "env": {
        "TAVILY_API_KEY": "${input:tavilyApiKey}",
        "MCP_API_KEY": "${input:mcpApiKey}"
      }
    }
  }
}
```

### 3. 在代码中使用

```python
from tavily_mcp import create_app
import uvicorn

app = create_app()

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8083)
```

### 4. API调用示例

```python
import requests

# 设置API基础URL和密钥
BASE_URL = "http://localhost:8083"
API_KEY = "your_mcp_api_key"

# 设置请求头
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

# Web搜索示例
response = requests.post(
    f"{BASE_URL}/tavily_web_search",
    headers=headers,
    json={
        "query": "Python编程语言介绍",
        "max_results": 5,
        "format_type": "markdown"
    }
)
```

## API文档

启动服务后，可以通过以下地址访问API文档：

- Swagger UI: `http://localhost:8083/docs`
- ReDoc: `http://localhost:8083/redoc`

## 环境变量

| 变量名 | 描述 | 必需 |
|--------|------|------|
| TAVILY_API_KEY | Tavily API密钥 | 是 |
| MCP_API_KEY | MCP服务API密钥 | 是 |
| HOST | 服务器主机地址 | 否 |
| PORT | 服务器端口 | 否 |
| LOG_LEVEL | 日志级别 | 否 |

## 开发

1. 克隆仓库：
```bash
git clone <repository-url>
cd tavily-mcp-server
```

2. 安装依赖：
```bash
pip install -e .
```

3. 运行测试：
```bash
python -m pytest
```

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request！