ApiCrate MCP服务器
](https://pypi.org/project/apicrate-mcp/)  
将任何与MCP兼容的AI代理连接到 22个数据工具 跨9个域——IP地理定位、电子邮件风险评分、邮政编码、国家、时区、用户代理解析、加密哈希、圣经搜索和二维码生成。
此套餐提供 本地STDIO传输 为了 ApiCrate MCP服务器。它将MCP客户端的工具调用代理到托管的API,因此API密钥保留在环境变量中,而不是配置文件中。
您还可以通过以下方式直接连接到托管服务器 可流式传输的HTTP 在 https://api.apicrate.io/mcp/ --无需安装。看 HTTP设置 在......下面快速开始
1.获取API密钥
免费注册 apicrate.io --无需信用卡。
2.安装
pip install apicrate-mcp或者在不安装的情况下运行:
uvx apicrate-mcp3.配置您的客户端
Claude Desktop
添加 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"apicrate": {
"command": "apicrate-mcp",
"env": {
"APICRATE_API_KEY": "ac_usr_your_key_here"
}
}
}
}Claude Code
claude mcp add apicrate -- apicrate-mcp然后设置密钥:
export APICRATE_API_KEY=ac_usr_your_key_here或者添加一个 .mcp.json 到您的项目根目录:
{
"mcpServers": {
"apicrate": {
"command": "apicrate-mcp",
"env": {
"APICRATE_API_KEY": "ac_usr_your_key_here"
}
}
}
}Cursor
添加 ~/.cursor/mcp.json:
{
"mcpServers": {
"apicrate": {
"command": "apicrate-mcp",
"env": {
"APICRATE_API_KEY": "ac_usr_your_key_here"
}
}
}
}Windsurf
添加 ~/.codeium/windsurf/mcp_settings.json:
{
"mcpServers": {
"apicrate": {
"command": "apicrate-mcp",
"env": {
"APICRATE_API_KEY": "ac_usr_your_key_here"
}
}
}
}流式HTTP(无需安装)
如果您的客户端支持Streamable HTTP,请跳过安装并直接连接:
{
"mcpServers": {
"apicrate": {
"type": "streamableHttp",
"url": "https://api.apicrate.io/mcp/",
"headers": {
"X-API-Key": "ac_usr_your_key_here"
}
}
}
}4.验证
问你的经纪人:
“哪个国家有代码DE?”
它应该呼叫 apicrate-lookup-country 并返回有关德国的信息。
工具
用户代理
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-parse-user-agent | 从UA字符串中解析浏览器、操作系统、设备和机器人 | 2 |
apicrate-parse-user-agents-bulk | 批量解析多达100个UA字符串 | 1/UA |
IP地理位置
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-geolocate-ip | 国家、城市、ISP、ASN和VPN/Tor检测 | 5 |
国家
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-lookup-country | 完整的ISO 3166-1记录——资本、货币、语言 | 1 |
apicrate-search-countries | 按地区、子地区或查询筛选 | 3 |
apicrate-validate-country-codes | 一次通话最多可验证50个国家代码 | 1/code |
邮政编码
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-lookup-postal-code | 解析到城市、行政区域和坐标 | 2 |
apicrate-validate-postal-code | 检查格式有效性和数据库是否存在 | 1 |
apicrate-search-postal-codes | 按前缀或地名搜索 | 3 |
apicrate-list-postal-systems | 列出所有有邮政编码数据的国家 | 2 |
apicrate-get-postal-system | 国家的格式、正则表达式和示例 | 2 |
apicrate-validate-postal-codes-bulk | 批量验证最多50个邮政编码 | 2/代码 |
apicrate-find-nearby-postal-codes | 查找GPS点半径范围内的代码 | 5 |
时区
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-get-timezone-info | 当前时间、UTC偏移和夏令时状态 | 1 |
apicrate-convert-time | 在两个时区之间转换时间 | 1 |
哈希
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-compute-hash | MD5、SHA-1、SHA-256或SHA-512 | 1 |
apicrate-hash-password | bcrypt、scrypt或argon2d | 2 |
圣经
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-get-bible-verse | 获取一首诗或30多种翻译的范围 | 1 |
apicrate-search-bible | 跨翻译的全文搜索 | 3 |
电子邮件风险
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-check-email-risk | 语法、MX、一次性、域名年龄、滥用列表 | 4 |
apicrate-check-email-risk-bulk | 批量评估最多10封电子邮件 | 4/封 |
二维码
| 工具 | 描述 | 积分 |
|---|---|---|
apicrate-generate-qr | 从文本、URL、WiFi、vCard、电子邮件、短信或地理位置生成二维码 | 2 |
示例提示
连接后,请尝试以下操作:
- “IP 203.0.113.5位于何处?”
- “邮政编码EC1A 1BB在哪个城市?”
- “为我解析此用户代理字符串”
- “将伦敦时间上午9点转换为东京时间”
- “使用argon2d对此密码进行哈希处理”
- “在NIV中查阅约翰福音3:16”
- “此电子邮件地址是否有风险:test@tempmail.com?"
- “查找柏林市中心10公里范围内的邮政编码”
配置
| 环境变量 | 默认值 | 描述 |
|---|---|---|
APICRATE_API_KEY | *(必填)* | 您的API密钥来自 apicrate.io |
APICRATE_BASE_URL | https://api.apicrate.io | API基本URL(用于测试/自托管) |
APICRATE_TIMEOUT | 30 | HTTP请求超时(秒) |
积分和定价
MCP工具调用从每日池中消耗信用,与REST API配额分开。
| 计划 | 积分/天 | 价格 |
|---|---|---|
| 启动器 | 100 | 免费 |
| 专业版 | 50000 | 19美元/月 |
| 企业 | 无限 | 自定义 |
每个响应都包含配额标头(X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset)所以你总是知道你的用法。
发展
# Clone the repo
git clone https://github.com/apicrateio/apicrate-mcp.git
cd apicrate-mcp
# Create a virtual environment
python -m venv .venv
source .venv/bin/activate
# Install in development mode
pip install -e ".[dev]"
# Run tests
pytest
# Run the server locally
APICRATE_API_KEY=ac_usr_your_key apicrate-mcp贡献
欢迎投稿!请参阅 贡献.md 作为指导方针。
