Skip to main content
Glama
apitier

APITier MCP Server

Official
by apitier

@apitier/mcp-server

MCP (模型上下文协议) 服务器,将所有 APITier 实用 API 作为 AI 代理的工具公开。

可用工具

工具

描述

lookup_uk_postcode

英国邮政编码 → 完整地址列表 + 地理编码

search_uk_address

自由文本英国地址搜索

autocomplete_uk_address

实时英国地址建议

validate_email

验证电子邮件 — 语法、MX、SMTP、一次性邮箱检查

validate_phone

验证并解析电话号码(国际)

validate_vat

验证欧盟/英国增值税号,返回注册企业信息

lookup_india_pincode

印度邮政编码 (PIN) → 州/区/城镇

generate_barcode

生成条形码图像 (Code128, EAN-13, UPC 等)

generate_qrcode

生成带有可选徽标 + 颜色的二维码图像

convert_data

在 CSV、JSON、XML、YAML 之间进行转换

Related MCP server: APIbase

设置

1. 获取您的 API 密钥

在 apitier.com 注册。每个 APITier 服务都有自己的订阅和 API 密钥。您只需要为您想要使用的服务获取密钥 — 未配置密钥的工具将自动从 MCP 工具列表中省略。

2. 安装

npm install -g @apitier/mcp-server
# or run directly without installing:
npx @apitier/mcp-server

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "apitier": {
      "command": "npx",
      "args": ["@apitier/mcp-server"],
      "env": {
        "APITIER_POSTCODE_KEY":     "key-from-postcode-subscription",
        "APITIER_EMAIL_KEY":        "key-from-email-subscription",
        "APITIER_PHONE_KEY":        "key-from-phone-subscription",
        "APITIER_VAT_KEY":          "key-from-vat-subscription",
        "APITIER_BARCODE_KEY":      "key-from-barcode-subscription",
        "APITIER_CONVERT_DATA_KEY": "key-from-data-conversion-subscription"
      }
    }
  }
}

仅为您订阅的服务设置密钥。重启 Claude Desktop — 您将只会看到您已订阅服务的工具。


Cursor / Windsurf / 其他 MCP 客户端

{
  "mcp": {
    "servers": {
      "apitier": {
        "command": "npx",
        "args": ["@apitier/mcp-server"],
        "env": {
          "APITIER_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

LangChain (Python)

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
from langchain_mcp_adapters.tools import load_mcp_tools
from langgraph.prebuilt import create_react_agent
from langchain_anthropic import ChatAnthropic

async def main():
    server_params = StdioServerParameters(
        command="npx",
        args=["@apitier/mcp-server"],
        env={"APITIER_API_KEY": "your-api-key"},
    )

    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await load_mcp_tools(session)

            model = ChatAnthropic(model="claude-sonnet-4-6")
            agent = create_react_agent(model, tools)

            result = await agent.ainvoke({
                "messages": "Validate this email: test@example.com and look up postcode SW1A 1AA"
            })
            print(result["messages"][-1].content)

Vercel AI SDK (TypeScript)

import { experimental_createMCPClient as createMCPClient } from "ai";
import { Experimental_StdioMCPTransport as StdioMCPTransport } from "ai/mcp-stdio";
import { anthropic } from "@ai-sdk/anthropic";
import { generateText } from "ai";

const mcp = await createMCPClient({
  transport: new StdioMCPTransport({
    command: "npx",
    args: ["@apitier/mcp-server"],
    env: { APITIER_API_KEY: process.env.APITIER_API_KEY! },
  }),
});

const tools = await mcp.tools();

const { text } = await generateText({
  model: anthropic("claude-sonnet-4-6"),
  tools,
  prompt: "Validate the email user@example.com and generate a QR code for https://apitier.com",
});

await mcp.close();

环境变量

变量

必需

描述

APITIER_EMAIL_KEY

是(至少一个)

来自您的电子邮件验证订阅的 API 密钥

APITIER_PHONE_KEY

是(至少一个)

来自您的电话验证订阅的 API 密钥

APITIER_VAT_KEY

是(至少一个)

来自您的增值税验证订阅的 API 密钥

APITIER_POSTCODE_KEY

是(至少一个)

来自您的英国邮政编码订阅的 API 密钥

APITIER_PINCODE_KEY

是(至少一个)

来自您的印度邮政编码订阅的 API 密钥

APITIER_BARCODE_KEY

是(至少一个)

来自您的条形码/二维码订阅的 API 密钥

APITIER_CONVERT_DATA_KEY

是(至少一个)

来自您的数据转换订阅的 API 密钥

APITIER_EMAIL_URL

否

覆盖电子邮件 API 基础 URL

APITIER_PHONE_URL

否

覆盖电话 API 基础 URL

APITIER_VAT_URL

否

覆盖增值税 API 基础 URL

APITIER_POSTCODE_URL

否

覆盖英国邮政编码 API 基础 URL

APITIER_PINCODE_URL

否

覆盖印度邮政编码 API 基础 URL

APITIER_BARCODE_URL

否

覆盖条形码 API 基础 URL

APITIER_CONVERT_DATA_URL

否

覆盖数据转换 API 基础 URL


开发

git clone https://github.com/apitier/apitier-mcp-server.git
cd apitier-mcp-server
npm install
npm run build
APITIER_API_KEY=your-key node dist/index.js

使用 MCP 检查器进行测试:

npx @modelcontextprotocol/inspector npx @apitier/mcp-server

在检查器的环境变量面板中设置 APITIER_API_KEY。


代理提示词示例

连接到 Claude Desktop 后,您可以说:

  • “验证此电子邮件列表并告诉我哪些是无效的:...”

  • “查找英国邮政编码 EC1A 1BB 并填写地址表单”

  • “为我们的公司网站生成一个带有我们徽标的二维码”

  • “我有一个 CSV 文件 — 请将其转换为 JSON”

  • “在发送发票之前验证此增值税号:GB123456789”

  • “验证这些电话号码并告诉我它们分别来自哪个国家:...”

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Unified MCP gateway for AI agents with 56+ tools and growing. Travel (Amadeus, Sabre GDS), e-commerce, local services, financial markets (Polymarket), and marketing APIs — all through a single endpoint. Pay-per-call via x402 micropayments in USDC.
    100
    24 npm
    10
    MIT
  • F
    license
    A
    quality
    F
    maintenance
    MCP server that exposes 300+ AI agents as tools via a single API key. Supports listing agents, invoking any agent with chat-completion style messages, checking agent health, and retrieving platform statistics.
    5
    4
    -