关于 APIVerve
APIVerve 是远程 MCP 服务,为 MCP 客户端提供数百种数据、验证和实用 API。其目录涵盖天气、位置、验证、转换和新闻等领域。
主要功能
- 01接入 387+ 种 API
- 02天气、位置和新闻数据
- 03验证与转换 API
- 04OAuth 2.0 或 API 密钥认证
- 05Streamable HTTP 连接
适用场景
- 01查询天气或空气质量
- 02验证电子邮件地址或域名
- 03转换货币或单位
- 04获取位置和新闻数据
MCP 相关
该远程服务通过 Streamable HTTP 将每种 APIVerve API 暴露为 MCP 工具。MCP 客户端可使用 OAuth 2.0 或 API 密钥进行认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.apiverve.com/v1/mcpclaude mcp add --transport http com-apiverve https://api.apiverve.com/v1/mcp{"mcpServers":{"com-apiverve":{"type":"http","url":"https://api.apiverve.com/v1/mcp"}}}在 Cursor 中打开{"servers":{"com-apiverve":{"type":"http","url":"https://api.apiverve.com/v1/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-apiverve":{"type":"http","url":"https://api.apiverve.com/v1/mcp"}}}{"mcpServers":{"com-apiverve":{"serverUrl":"https://api.apiverve.com/v1/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
APIVerve MCP 服务
🚀 概览
APIVerve MCP 服务通过 Model Context Protocol 无缝提供对 387+ 个可投入生产使用的 API 的访问。将 Claude、ChatGPT 等 AI 助手以及其他兼容 MCP 的客户端连接到庞大的数据与功能生态系统。
✨ 功能
- 🎯 387+ 个 API - 天气、新闻、地理编码、验证、转换等
- 🔐 OAuth 2.0 身份验证 - 安全、符合行业标准的身份验证
- 📊 基于 Token 的定价 - 只为实际使用的内容付费
- 🚀 高性能 - 云端托管,正常运行时间超过 99%
- 📖 丰富的文档 - 完整的 API 文档及示例
- 🔄 自动更新 - 始终使用最新的 API 功能
📦 安装
APIVerve 是一个远程 MCP 服务,无需在本地运行任何程序。将客户端指向下方的 URL,即可自动完成登录。
一键安装
此仓库同时也是一个 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:
使用 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
🔧 故障排除
连接问题
如果您看到身份验证错误:
- 在 https://apiverve.com/dashboard 检查您的 API 密钥
- 确保 OAuth 重定向 URI 正确
- 尝试重新授权连接
令牌限制
如果达到令牌限制:
- 在 https://apiverve.com/dashboard 查看用量
- 升级您的套餐
- 联系支持团队,了解企业方案
📚 文档
- API 文档:https://docs.apiverve.com
- MCP 规范:modelcontextprotocol.io
- 入门指南:https://apiverve.com/docs/getting-started
🤝 支持
- GitHub 问题:apiverve/mcp-server/issues
- 邮箱:[email protected]
- 隐私政策:apiverve.com/privacy
- Discord:加入我们的社区
📄 许可证
本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。
🌟 为我们点星!
如果您觉得这个项目很有用,请考虑在 GitHub 上为仓库点星!
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。