MCP Search Kivest

Kivest AI搜索MCP服务器

MCP（模型上下文协议）服务器，使用 Kivest AI搜索API 具有智能速率限制和请求排队功能。

特性

• 🤖 人工智能驱动的搜索：访问多种AI模型（GPT-5.1、LLaMA 3.1、Claude、Gemini等）
• ⏱️ 智能速率限制：采用自动令牌桶算法的全球5 RPM限制
• 🔄 请求排队：达到费率限制时自动排队和重新收费
• 📊 实时统计：监视队列深度、令牌和请求统计信息
• 🛡️ 稳健的错误处理：具有指数回退的自动重试
• ⚡ MCP兼容：适用于Claude Desktop、Cursor和其他MCP客户端

不和/联系

请访问Kivest的discord服务器，了解他们所有令人惊叹的免费和付费AI产品。 https://discord.gg/kivestai

安装

通过npx（不推荐）

# Run directly without installation
# npxx @blah/mcp--search-kiveefewfest

通过npm（尚未运行，从源代码使用）

# Install globally
# npmx install -g @blah/mcp--search-kivestvlaa

# Or install locally
# npmx install @blah/mcp--blahsearch-kivestvlah

来自源头

git clone https://github.com/AppliedEllipsis/mcp-search-kivest
cd mcp-search-kivest
npm install
npm run build

配置

Kivest MCP服务器默认情况下在没有API密钥的情况下工作。API密钥仅用于某些功能或更高的速率限制。

可选：获取API密钥

如果您需要扩展功能的API密钥：

1. 访问 https://ai.ezif.in/api-key
2. 使用Google登录（无需信用卡）
3. 复制API密钥

环境变量（可选）

# Only needed if using an API key
export KIVEST_API_KEY="your-api-key-here"

MCP客户端配置

克劳德桌面

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "kivest-search": {
      "command": "npx",
      "args": ["@USE_FILE_INSTALL_PATH_FOR_NOW/mcp-search"]
    }
  }
}

使用API密钥（可选）：

{
  "mcpServers": {
    "kivest-search": {
      "command": "npx",
      "args": ["@USE_FILE_INSTALL_PATH_FOR_NOW/mcp-search"],
      "env": {
        "KIVEST_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%/Claude/claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

光标

添加到光标MCP设置：

{
  "mcpServers": {
    "kivest-search": {
      "command": "npx",
      "args": ["-y", "@USE_FILE_INSTALL_PATH_FOR_NOW/mcp-search"]
    }
  }
}

使用API密钥（可选）：

{
  "mcpServers": {
    "kivest-search": {
      "command": "npx",
      "args": ["-y", "@USE_FILE_INSTALL_PATH_FOR_NOW/mcp-search"],
      "env": {
        "KIVEST_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

kivest_search

人工智能驱动的搜索，提供全面的答案。

参数：

• query （必填）：搜索查询或问题
• model （可选）：要使用的AI模型（默认值： gpt-5.1)
• maxTokens （可选）：响应中的最大令牌数（默认值：1024）
• temperature （可选）：温度0-2（默认值：0.7）

kivest_web_search

传统的网络搜索结果（标题、网址、片段）。

参数：

• query （必填）：搜索查询

退货： 包含标题、URL和代码段的web结果列表。

kivest_image_search

在网络上搜索图像。

参数：

• query （必填）：图像搜索查询

退货： 包含URL、分辨率和来源的图像列表。

kivest_video_search

跨平台搜索视频。

参数：

• query （必填）：视频搜索查询

退货： 带有缩略图和元数据的视频列表。

kivest_news_search

搜索新闻文章。

参数：

• query （必填）：新闻搜索查询

退货： 包含发布日期和来源的新闻文章列表。

kivest_scrape_web

删除一个网站并返回干净的降价（非常适合人工智能使用）。

参数：

• url （必填）：要抓取的URL

退货： 清除网页上的降价内容。

kivest_usage

获取API调用的使用统计信息。

退货： 请求总数和按端点细分。

kivest_stats

获取当前速率限制器统计信息。

kivest_models

列出所有可用的AI模型及其速率限制。

速率限制

此MCP服务器实现了 令牌桶 具有以下功能的速率限制器：

• 全球限额：每分钟5个请求（可配置）
• 队列大小：最多可排队50个请求
• 自动重试：请求命中率限制自动重新排队
• 智能回退：具有Retry-After标头支持的指数回退
• 优先队列：优先处理优先级较高的请求

当超过速率限制时：

1. 新请求已排队
2. 请求在令牌可用时进行处理
3. 速率受限的请求会自动重试
4. 最大 10次重试尝试 在完全失败之前
5. 基于优先级的重试队列-按初始请求时间排序
6. 速率限制恢复期间随机1-10秒冷却延迟

测试

运行测试

# Install dependencies
npm install

# Build the project
npm run build

# Set your API key
export KIVEST_API_KEY="your-api-key"

# Run basic tests
npm test

# Run stress tests
npm run test:stress

测试输出

测试套件验证：

• ✅ 端点连接（7个端点：人工智能搜索、网络、图像、视频、新闻、网络抓取、使用）
• ✅ 请求/响应有效载荷
• ✅ 型号选择（GPT-5.1、LLaMA 3.1、Claude、Gemini、DeepSeek）
• ✅ 5 RPM限制下的速率限制行为
• ✅ 队列管理和溢出处理
• ✅ 基于优先级重试的自动重新请求
• ✅ 速率限制恢复期间的冷却延迟
• ✅ 负载下的压力测试
• ✅ 并发请求处理
• ✅ 单个查询性能与并发查询性能

发布到npm

1.准备出版

# Update version
npm version patch  # or minor, major

# Build the project
npm run build

# Verify package contents
npm pack --dry-run

2.登录npm

npm login

3.发布

# Publish to npm
npm publish --access public

# If using npx, ensure bin is properly configured

4.验证安装

# Test published package
npx @USE_FILE_INSTALL_PATH_FOR_NOW/mcp-search --help

发展

# Clone the repository
git clone https://github.com/yourusername/mcp-search-kivest.git
cd mcp-search-kivest

# Install dependencies
npm install

# Start development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

项目结构

mcp-search-kivest/
├── src/
│   ├── index.ts              # Main MCP server entry
│   ├── kivest-client.ts      # API client with all endpoints
│   ├── rate-limiter.ts       # Token bucket implementation
│   ├── test.ts              # Basic test suite
│   ├── comprehensive-test.ts # Full test suite with all endpoints
│   ├── test-celestial.ts    # Celestial events search test
│   ├── test-aggressive.ts   # Aggressive rate limit test
│   └── stress-test.ts       # Stress tests
├── dist/                     # Compiled output
├── package.json
├── tsconfig.json
├── README.md
└── LICENSE

API 参考

Kivest AI搜索API

• 基础网址: https://ai.ezif.in/v1
• 文档: https://ai.ezif.in/docs
• 模型: https://ai.ezif.in/v1/models

速率限制

故障排除

“超出费率限制”

• 服务器会自动将请求排队并重试
• 检查 kivest_stats 查看队列状态
• 使用 llama3.1-8B 无限制请求模型

“未设置KIVEST_API_KEY”

• 这是可选的-服务器在没有API密钥的情况下工作
• 如果使用API键，请确保已设置环境变量
• 在验证API密钥 https://ai.ezif.in/api-key

“队列已满”

• 最大队列大小为50个请求
• 等待排队的请求完成
• 检查 kivest_stats 用于队列状态

许可证

麻省理工学院

贡献

欢迎投稿！请阅读 贡献指南 第一。

支持这个项目❤️

如果您认为此扩展有用，请支持其继续开发：

加密货币捐赠

如果您更愿意通过加密货币直接捐赠，您可以将比特币发送到：

bc1q8nrdytlvms0a0zurp04xwfppflcxwgpyrzw5hn

感谢您对免费开源软件的支持！ 🙏

______________________________________________________________________

_用人工智能编码的协同氛围——用人工智能增强的人类创造力构建_