mcpField
A
APIVerve

APIVerve

远程服务
github.com/apiverve开发工具32 天前更新
代码仓库

关于 APIVerve

APIVerve 是远程 MCP 服务,为 MCP 客户端提供数百种数据、验证和实用 API。其目录涵盖天气、位置、验证、转换和新闻等领域。

主要功能

  1. 01接入 387+ 种 API
  2. 02天气、位置和新闻数据
  3. 03验证与转换 API
  4. 04OAuth 2.0 或 API 密钥认证
  5. 05Streamable HTTP 连接

适用场景

  1. 01查询天气或空气质量
  2. 02验证电子邮件地址或域名
  3. 03转换货币或单位
  4. 04获取位置和新闻数据

MCP 相关

该远程服务通过 Streamable HTTP 将每种 APIVerve API 暴露为 MCP 工具。MCP 客户端可使用 OAuth 2.0 或 API 密钥进行认证。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://api.apiverve.com/v1/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

APIVerve MCP 服务

APIVerve 标志

通过 Model Context Protocol 访问 387+ 个 API

npm version PyPI version License: MIT MCP Compatible

网站 • 文档 • API 浏览器 • 报告 Bug

🚀 概览

APIVerve MCP 服务通过 Model Context Protocol 无缝提供对 387+ 个可投入生产使用的 API 的访问。将 Claude、ChatGPT 等 AI 助手以及其他兼容 MCP 的客户端连接到庞大的数据与功能生态系统。

✨ 功能
  • 🎯 387+ 个 API - 天气、新闻、地理编码、验证、转换等
  • 🔐 OAuth 2.0 身份验证 - 安全、符合行业标准的身份验证
  • 📊 基于 Token 的定价 - 只为实际使用的内容付费
  • 🚀 高性能 - 云端托管,正常运行时间超过 99%
  • 📖 丰富的文档 - 完整的 API 文档及示例
  • 🔄 自动更新 - 始终使用最新的 API 功能

📦 安装

APIVerve 是一个远程 MCP 服务,无需在本地运行任何程序。将客户端指向下方的 URL,即可自动完成登录。

一键安装

Add APIVerve to Cursor Install in VS Code

此仓库同时也是一个 Cursor 插件(.cursor-plugin/)和 Gemini CLI 扩展(gemini-extension.json):每个扩展都会添加此服务,以及一项技能,用于告知 Agent 何时以及如何使用这些工具。

Gemini CLI:

gemini extensions install https://github.com/apiverve/mcp-server
快速设置
npx @apiverve/mcp-server

此命令会配置 VS Code 和 Cursor,并打印 Claude Desktop 的手动设置步骤。使用 npx @apiverve/mcp-server cursor 可指定一个客户端。

对于无头环境,可传入密钥,而不是使用登录:

npx @apiverve/mcp-server --api-key YOUR_API_KEY

Python 用户也可以执行 pip install apiverve-mcp,然后运行 apiverve-mcp(或 apiverve-mcp --api-key YOUR_API_KEY)。

手动设置

Claude Desktop — 远程服务需通过应用添加,而不是通过配置文件:

设置 → 连接器 → 添加自定义连接器 → https://api.apiverve.com/v1/mcp

VS Code(mcp.json):

{
  "servers": {
    "apiverve": {
      "type": "http",
      "url": "https://api.apiverve.com/v1/mcp"
    }
  }
}

Cursor(~/.cursor/mcp.json):

{
  "mcpServers": {
    "apiverve": {
      "url": "https://api.apiverve.com/v1/mcp"
    }
  }
}

🔑 身份验证

有两种方式可供选择:

OAuth(默认,推荐) — 按照上方所示保留配置。首次使用时,服务会返回授权质询,客户端将引导你完成登录。密钥不会存储在磁盘上,并且可以从控制面板撤销访问权限。

API 密钥 — 将密钥添加为标头。适用于没有浏览器可用的 CI 和无头环境:

{
  "mcpServers": {
    "apiverve": {
      "url": "https://api.apiverve.com/v1/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop 的自定义连接器无法发送自定义标头,因此只能使用 OAuth。

请前往 https://apiverve.com 获取密钥。提供免费套餐 — 开始使用无需信用卡!

🎯 可用 API

点击查看全部 387+ 个可用 API
🌤️ 天气与环境
  • 天气预报
  • 空气质量
  • 海洋天气
  • 紫外线指数
  • 天气季节
  • 更多...
🌍 位置与地理编码
  • 反向地理编码
  • IP 查询
  • 时区查询
  • 机场查询
  • 距离计算器
  • 等等……
✅ 验证与核验
  • 邮箱验证器
  • 电话号码验证器
  • 域名可用性查询
  • SSL 证书检查器
  • 等等……
🔄 转换与计算
  • 货币转换器
  • 单位转换器
  • 日期计算器
  • BMI 计算器
  • 等等……
📰 新闻与内容
  • 全球新闻
  • RSS 转 JSON
  • 网页抓取工具
  • 元数据提取器
  • 等等……
🎲 随机数据生成器
  • 随机用户生成器
  • 密码生成器
  • Lorem Ipsum 生成器
  • 等等……

查看完整 API 列表 →

💡 使用示例

配置完成后,即可在对话中自然地使用 API:

使用 Claude Desktop
User: What's the weather in San Francisco?
Claude: [Uses Weather API]

User: Validate this email: [email protected]
Claude: [Uses Email Validator API]

User: Convert 100 USD to EUR
Claude: [Uses Currency Converter API]
编程使用(Python)

直接连接远程服务,无需涉及本地进程:

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

url = "https://api.apiverve.com/v1/mcp"
headers = {"x-api-key": "YOUR_API_KEY"}

async with streamablehttp_client(url, headers=headers) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()

        # List available tools
        tools = await session.list_tools()

        # Call a tool
        result = await session.call_tool("emailvalidator", {
            "email": "[email protected]"
        })

📊 定价

APIVerve 采用灵活的基于令牌的定价模式,提供多个套餐以满足您的需求:

  • 提供免费套餐 - 无需信用卡,即可立即开始构建
  • 按需付费 - 随着使用量增长灵活扩展
  • 企业套餐 - 为高用量用户提供定制解决方案

查看定价方案 →

积分消耗因 API 复杂度而异,简单 API 每次调用仅需 1 积分。

🛠️ 技术详情

服务信息
  • 传输方式:Streamable HTTP
  • 协议:MCP 2025-06-18(协商降级至 2025-03-26 和 2024-11-05)
  • 身份验证:OAuth 2.0 with PKCE,或 x-api-key 标头
  • 基础 URL:https://api.apiverve.com/v1/mcp
  • API 版本:1.1.1
OAuth 端点
  • 发现:https://api.apiverve.com/.well-known/openid-configuration
  • 授权:https://api.apiverve.com/authorize
  • 令牌:https://api.apiverve.com/token
  • 注册:https://api.apiverve.com/register(动态客户端注册)
工具架构

每个 API 都会作为 MCP 工具公开,包含:

  • name:API 标识符(例如,emailvalidator)
  • description:包含令牌成本的易读描述
  • inputSchema:定义必需和可选参数的 JSON Schema

🔧 故障排除

连接问题

如果您看到身份验证错误:

  1. 在 https://apiverve.com/dashboard 检查您的 API 密钥
  2. 确保 OAuth 重定向 URI 正确
  3. 尝试重新授权连接
令牌限制

如果达到令牌限制:

📚 文档

🤝 支持

📄 许可证

本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。

🌟 为我们点星!

如果您觉得这个项目很有用,请考虑在 GitHub 上为仓库点星!


由 APIVerve 倾心打造 ❤️

网站 • 仪表板 • API 浏览器 • 文档

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。