内容
# APIVerve MCP 服务器
<div align="center">
<img src="https://apiverve.com/images/favicon.png" alt="APIVerve Logo" width="80" />
**368+ 个 API 通过模型上下文协议可访问**
[](https://www.npmjs.com/package/@apiverve/mcp-server)
[](https://pypi.org/project/apiverve-mcp/)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[网站](https://apiverve.com) • [文档](https://docs.apiverve.com) • [API 资源管理器](https://apiverve.com/marketplace) • [报告问题](https://github.com/apiverve/mcp-server/issues)
</div>
## 🚀 概述
**APIVerve MCP 服务器** 通过 [模型上下文协议](https://modelcontextprotocol.io) 提供对 368+ 个生产就绪 API 的无缝访问。连接 AI 助手（如 Claude、ChatGPT）和其他 MCP 兼容客户端到一个庞大的数据和功能生态系统。
### ✨ 功能
- 🎯 **368+ 个 API** - 天气、新闻、地理编码、验证、转换等
- 🔐 **OAuth 2.0 身份验证** - 安全、行业标准的身份验证
- 📊 **基于令牌的定价** - 只需支付您使用的费用
- 🚀 **高性能** - 云托管，99%+ 正常运行时间
- 📖 **丰富的文档** - 完整的 API 文档，包含示例
- 🔄 **自动更新** - 始终访问最新的 API 功能
## 📦 安装
APIVerve 是一个**远程** MCP 服务器 - 本地无需运行任何程序。只需将您的客户端指向以下 URL，它将为您处理登录。
### 快速设置
```bash
npx @apiverve/mcp-server
```
配置 VS Code 和 Cursor，并打印 Claude Desktop 的手动步骤。目标客户端使用 `npx @apiverve/mcp-server cursor`。
对于无头设置，请传递一个密钥而不是使用登录:
```bash
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`)：
```json
{
"servers": {
"apiverve": {
"type": "http",
"url": "https://api.apiverve.com/v1/mcp"
}
}
}
```
**Cursor** (`~/.cursor/mcp.json`)：
```json
{
"mcpServers": {
"apiverve": {
"url": "https://api.apiverve.com/v1/mcp"
}
}
}
```
## 🔑 身份验证
两种方式 - 选择适合您的方式:
**OAuth（默认，推荐）** - 保留上述配置。首次使用时，服务器返回身份验证挑战，您的客户端引导您完成登录。磁盘上不存储密钥，访问权限可以在仪表板上撤销。
**API 密钥** - 将您的密钥作为标头添加。对于 CI 和无头环境很有用，无需浏览器:
```json
{
"mcpServers": {
"apiverve": {
"url": "https://api.apiverve.com/v1/mcp",
"headers": { "x-api-key": "YOUR_API_KEY" }
}
}
}
```
Claude Desktop 的自定义连接器无法发送自定义标头，因此仅支持 OAuth。
在 [https://apiverve.com](https://apiverve.com) 获取密钥。**免费层可用** - 无需信用卡即可开始！
## 🎯 可用 API
<details>
<summary><b>点击查看所有 368+ 可用 API</b></summary>
### 🌤️ 天气和环境
- 天气预报
- 空气质量
- 海洋天气
- 紫外线指数
- 天气季节
- 等等...
### 🌍 位置和地理编码
- 反向地理编码
- IP 查询
- 时区查询
- 机场查询
- 距离计算器
- 等等...
### ✅ 验证和校验
- 电子邮件验证器
- 电话号码验证器
- 域名可用性
- SSL 证书检查器
- 等等...
### 🔄 转换和计算
- 货币转换器
- 单位转换器
- 日期计算器
- BMI 计算器
- 等等...
### 📰 新闻和内容
- 世界新闻
- RSS 转 JSON
- 网络爬虫
- 元数据提取器
- 等等...
### 🎲 随机数据生成器
- 随机用户生成器
- 密码生成器
- Lorem Ipsum 生成器
- 等等...
**[查看完整 API 列表 →](https://apiverve.com/marketplace)**
</details>
## 💡 使用示例
配置完成后，在对话中自然使用 API：
### 在 Claude Desktop 上
```
用户：旧金山的天气怎么样？
Claude：[使用天气 API]
用户：验证此电子邮件：test@example.com
Claude：[使用电子邮件验证器 API]
用户：将 100 美元转换为欧元
Claude：[使用货币转换器 API]
```
### 以编程方式使用（Python）
直接连接到远程服务器 - 不涉及本地进程:
```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()
# 列出可用工具
tools = await session.list_tools()
# 调用工具
result = await session.call_tool("emailvalidator", {
"email": "test@example.com"
})
```
## 📊 定价
APIVerve 使用灵活的基于令牌的定价模型，拥有多个层级以满足您的需求:
- **免费层可用** - 立即开始构建，无需信用卡
- **按需付费** - 随着使用量增长而扩展
- **企业计划** - 为高容量用户提供定制解决方案
**[查看定价计划 →](https://apiverve.com/pricing)**
信用成本因 API 复杂性而异 - 简单 API 每次调用起价为 1 信用。
## 🛠️ 技术细节
### 服务器信息
- **传输**: 流式 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.0
### 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 工具公开，包含:
- **名称**: API 标识符（例如 `emailvalidator`）
- **描述**: 具有令牌成本的人类可读描述
- **inputSchema**: 定义必填/可选参数的 JSON 模式
## 🔧 故障排除
### 连接问题
如果您看到身份验证错误:
1. 在 [https://apiverve.com/dashboard](https://apiverve.com/dashboard) 检查您的 API 密钥
2. 确保 OAuth 重定向 URI 正确
3. 尝试重新授权连接
### 令牌限制
如果您达到令牌限制:
- 在 [https://apiverve.com/dashboard](https://apiverve.com/dashboard) 检查使用情况
- 升级您的计划
- 联系支持团队以获取企业选项
## 📚 文档
- **API 文档**: [https://docs.apiverve.com](https://docs.apiverve.com)
- **MCP 规范**: [modelcontextprotocol.io](https://modelcontextprotocol.io)
- **入门指南**: [https://apiverve.com/docs/getting-started](https://apiverve.com/docs/getting-started)
## 🤝 支持
- **GitHub 问题**: [apiverve/mcp-server/issues](https://github.com/apiverve/mcp-server/issues)
- **电子邮件**: hello@apiverve.com
- **Discord**: [加入我们的社区](https://apiverve.com/discord)
## 📄 许可证
该项目根据 MIT 许可证授权 - 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。
## 🌟 给我们点赞！
如果您觉得此项目有帮助，请考虑在 GitHub 上给我们点赞！
---
<div align="center">
**由 [APIVerve](https://apiverve.com) 用 ❤️ 构建**
[网站](https://apiverve.com) • [仪表板](https://apiverve.com/dashboard) • [API 资源管理器](https://apiverve.com/marketplace) • [文档](https://docs.apiverve.com)
</div>
