原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Ktemia

作者:Ktemiaa版本 0.1.5i★ 2i电脑或云端官方网站 ↗
注册名称io.github.Ktemiaa/ktemia-mcp

安装方法

What it does

Search and compare flights, hotels and rental cars, with each seller's price and booking link.

  • Connects 电脑或云端
  • Account or key Cloud: Needs X-API-Key · Local: Needs KTEMIA_API_KEY
  • Category 旅行、地图与天气

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度19/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应8/8上次检查时云端端点有响应
使用分39/100

质量: 基础检查通过 5/5 项(仅展示,不用于排序) · 上升势头: 25 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

用一句话让 AI 帮你安装

请帮我安装 Ktemia。按照 https://mcp.popnx.com/i/ktemiaa-ktemia-mcp.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 5/5 项检查 · 你的提问会经过开发者的服务器(mcp.ktemia.com) · ✓ 命令已检查 2026年11月19日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude · 约 5 分钟

需要 Ktemia 的密钥(在开发者网站创建) · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加

  1. 注册并创建 Ktemia 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    打开 Ktemia 网站 ↗

  2. 打开 Claude 的 Connectors 页面

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 点击“Add” → “Custom” → “Web”,填写这 2 项

    把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue

    Name · 名称Ktemia
    Remote MCP server URL · 地址https://mcp.ktemia.com/mcp

    在 Request headers 下添加这个名称和值

    Header 名称X-API-Key
    值<在这里粘贴你的密钥>

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

    在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add

  4. 在聊天中开启

    +ConnectorsKtemia

  5. 试一试

    用 Ktemia 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 Ktemia,或回答中出现 Ktemia 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

ChatGPT 暂时无法连接 Ktemia

Ktemia 连接时需要你自己的密钥,但 OpenAI 帮助页面只说明了 OAuth 登录,没有我们能核实的填密钥方式

你可以改用这些方式

A · 使用能连接 Ktemia 的应用

  • 需要 Ktemia 的密钥(在开发者网站创建) · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
  • 需要 Ktemia 的密钥(在开发者网站创建)
  • 需要 Ktemia 的密钥(在开发者网站创建)
  • 需要 Ktemia 的密钥(在开发者网站创建)

B · 旅行、地图与天气 类中能连接 ChatGPT 的其他服务器

从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的

可连接 Claude Code · 约 5 分钟

需要 Ktemia 的密钥(在开发者网站创建)

  1. 注册并创建 Ktemia 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    打开 Ktemia 网站 ↗

  2. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  3. 粘贴这条命令并按 Enter

    claude mcp add --transport http --scope user ktemia https://mcp.ktemia.com/mcp --header 'X-API-Key: your-value'

    按 Enter 前,把“your-value”改成你的密钥

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  4. 在 Claude Code 中输入 /mcp

    应能看到 Ktemia 在列表中并显示已连接

  5. 试一试

    用 Ktemia 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 Ktemia,或回答中出现 Ktemia 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 5 分钟

需要 Ktemia 的密钥(在开发者网站创建)

  1. 注册并创建 Ktemia 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    打开 Ktemia 网站 ↗

  2. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  3. 填写你的密钥

    在 Ktemia 的设置中,X-API-Key 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  4. 在 Cursor 中以 Agent 模式打开 AI 聊天

  5. 试一试

    用 Ktemia 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 Ktemia,或回答中出现 Ktemia 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 5 分钟

需要 Ktemia 的密钥(在开发者网站创建)

  1. 注册并创建 Ktemia 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    打开 Ktemia 网站 ↗

  2. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  3. 填写你的密钥

    在 Ktemia 的设置中,X-API-Key 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  4. 在 VS Code 中以 Agent 模式打开 AI 聊天

  5. 试一试

    用 Ktemia 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 Ktemia,或回答中出现 Ktemia 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://mcp.ktemia.com/mcp

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 Ktemia 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

Claude Code

claude mcp add --transport http --scope user ktemia https://mcp.ktemia.com/mcp --header 'X-API-Key: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ktemia": {
      "url": "https://mcp.ktemia.com/mcp",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ktemia": {
      "type": "http",
      "url": "https://mcp.ktemia.com/mcp",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

安装在电脑上

Claude Code

claude mcp add --scope user ktemia --env KTEMIA_API_KEY=your-value -- npx -y @ktemia/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ktemia": {
      "command": "npx",
      "args": [
        "-y",
        "@ktemia/mcp"
      ],
      "env": {
        "KTEMIA_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ktemia": {
      "command": "npx",
      "args": [
        "-y",
        "@ktemia/mcp"
      ],
      "env": {
        "KTEMIA_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ktemia": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ktemia/mcp"
      ],
      "env": {
        "KTEMIA_API_KEY": "your-value"
      }
    }
  }
}

需要你填写的值

  • KTEMIA_API_KEY 机密 必填 env
    您的 Ktemia API 密钥。可在 https://app.ktemia.com/api-keys 免费获取一个。
    查看英文原文Your Ktemia API key. Get a free one at https://app.ktemia.com/api-keys
  • X-API-Key 机密 必填 HTTP header
    您的 Ktemia API 密钥。可在 https://app.ktemia.com/api-keys 免费获取一个。
    查看英文原文Your Ktemia API key. Get a free one at https://app.ktemia.com/api-keys

说明为自动翻译,变量名保持原样;不确定时请查看原文。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
546/周
连接方式
电脑或云端
传输方式
stdio, streamable-http
最新版本i
0.1.5
发布到注册中心i
2026年11月19日
代码最后更新i
2026年11月19日
最近检查
2026年11月19日
作者
Ktemiaa
软件包
npm: @ktemia/mcp
pypi: ktemia-mcp
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

通过互联网连接,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

在你的电脑上运行,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

全部应用及其优缺点 →

它能做什么

服务器要求先登录,才会列出它的工具。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月20日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 Ktemiaa 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于昨天

  • ✓ 通过

    有许可证

    使用 MIT

  • ✓ 通过

    端点有响应

    在 253 毫秒内响应(HTTP 401)

  • ✓ 通过

    使用 OAuth 登录

    声明支持 OAuth 登录,你的 AI 应用可以带你去登录

  • … 尚未检查

    工具描述中没有隐藏指令

    尚未检查;我们会在检查端点时读取工具列表

已公开的漏洞(OSV.dev)

尚未检查

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ktemiaa-ktemia-mcp.svg)](https://mcp.popnx.com/en/servers/ktemiaa-ktemia-mcp)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“旅行、地图与天气”中的其他服务器比较i

  • 星标数多于此分类中其他 2025 个服务器的 92%
  • 发布到注册中心的时间比此分类中其他 2025 个服务器的 99% 更新
  • 基础检查结果等于或优于此分类中其他 2025 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Ktemia 安全吗?

它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:X-API-Key, KTEMIA_API_KEY

它在我的电脑上运行还是在云端?

两种方式都可以:安装在你的电脑上,或者连接云端版本。

它还在维护吗?

GitHub 仓库最后更新于昨天,最新版本(0.1.5)于昨天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。

有什么可以替代它?

同一分类中有:Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

作者:micro正在增长★ 4404个月前更新

在云端运行✓ micro.mu

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

作者:tengolabs起步阶段↓ 328/周★ 1413天前更新

在你的电脑上运行✓ 服务方 · killbottleneck.com

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

作者:WhimsicalCode起步阶段★ 112个月前更新

在云端运行✓ 服务方 · whimsical.com
与相似项目对比
本项
Ktemia
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
运行位置云端或安装在电脑上都可以在云端运行,无需安装在云端运行,无需安装需要安装在电脑上在云端运行,无需安装在云端运行,无需安装
需要密钥是否否是否否
可在 Claude 中按 + 添加否否否否否是
基础检查5/54/43/33/34/44/4
许可证MITAGPL-3.0MITMITMITMIT
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Ktemia MCP server

A Model Context Protocol server that searches and compares flights, hotels, and rental cars with the Ktemia API. Point Cursor, Claude Code, Claude Desktop, Codex, or any MCP client at it, ask in plain language, and the agent looks up the place, runs the search, and returns each seller's price with a booking link.

Available for both Node (npx -y @ktemia/mcp) and Python (uvx ktemia-mcp).

[Get a free API key](https://app.ktemia.com/api-keys) · API reference · Getting started · Pricing · Guide: flights in Cursor and Claude · Changelog

Ktemia compares prices. It does not book the ticket, the car, or the room. The traveller books on the seller's site.

ToolUse it for
ktemia_key_statusPlan, rate limits, and requests left this month. Costs no quota.
ktemia_lookupAirport, airline, hotel, and car rental location codes
ktemia_search_flightsOne-way, round trip, and multi-city fares
ktemia_search_hotelsStays, with stars, ratings, and amenity filters
ktemia_search_carsA hire at a city or airport
ktemia_get_detailsEvery price and booking link for one chosen result
ktemia_get_hotel_reviewsGuest reviews for one hotel

Every plan can use the MCP server, including the Free plan with its 100 requests a month. A paid plan buys request volume and rate, not access.

Two packages, one behaviour

The server ships in both languages, so you can run it with whichever runtime your machine already has:

PackageCommandNeeds
Node@ktemia/mcpnpx -y @ktemia/mcpNode 20+
Pythonktemia-mcpuvx ktemia-mcpPython 3.10+ and uv

They are not two codebases that happen to agree. Both read one shared contract, spec/tools.json, for every tool name, description, enum, and limit, and CI fails if they drift. Same seven tools, same wording, same errors — pick either.

npx and uvx both fetch the package on first run and cache it, so there is nothing to install or upgrade by hand.

Install

You need an API key from app.ktemia.com/api-keys. Free, no card.

Each example below shows Node first, then Python. Use one, not both — two copies of the same server would just show every tool twice.

Cursor

Add to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):

{

"mcpServers": { "ktemia": { "command": "npx", "args": ["-y", "@ktemia/mcp"], "env": { "KTEMIA_API_KEY": "${env:KTEMIA_API_KEY}" } } } }

Python instead:

{

"mcpServers": { "ktemia": { "command": "uvx", "args": ["ktemia-mcp"], "env": { "KTEMIA_API_KEY": "${env:KTEMIA_API_KEY}" } } } }

${env:KTEMIA_API_KEY} reads the key from your shell environment, so the key itself is not committed in a project file. Export it in your shell profile:

export KTEMIA_API_KEY="your-key"

To paste the key directly instead, put it in ~/.cursor/mcp.json rather than a project file, and do not commit it.

Claude Code
claude mcp add ktemia -e KTEMIA_API_KEY=your-key -- npx -y @ktemia/mcp

Python instead:

claude mcp add ktemia -e KTEMIA_API_KEY=your-key -- uvx ktemia-mcp

Everything after -- is the command Claude Code runs. Check it with claude mcp list.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows:

{

"mcpServers": { "ktemia": { "command": "npx", "args": ["-y", "@ktemia/mcp"], "env": { "KTEMIA_API_KEY": "your-key" } } } }

Python instead: "command": "uvx", "args": ["ktemia-mcp"].

Restart Claude Desktop, then ask for a flight.

Claude Desktop launches servers from a GUI process that does not read your shell profile, so npx or uvx must be somewhere it can see. If the server fails to start, use the absolute path from which npx or which uvx as command.

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.ktemia]

command = "npx" args = ["-y", "@ktemia/mcp"] env = { KTEMIA_API_KEY = "your-key" }

Python instead:

[mcp_servers.ktemia]

command = "uvx" args = ["ktemia-mcp"] env = { KTEMIA_API_KEY = "your-key" }

Any other MCP client

The server speaks MCP over stdio. Run npx -y @ktemia/mcp or uvx ktemia-mcp with KTEMIA_API_KEY in the environment.

It negotiates the protocol revision per connection, so it answers both current (2026-07-28) clients and clients that still open with the older initialize handshake.

Check it before wiring it up

Run the command in a terminal first:

KTEMIA_API_KEY=your-key npx -y @ktemia/mcp     # or: uvx ktemia-mcp

It should sit silently waiting for JSON-RPC on stdin; Ctrl-C to quit. An immediate error means the environment is wrong, and reading it here is easier than digging through a client's logs.

Try it

Find flights from Lisbon to London on 15 March 2027.

I need a car at Austin airport from 10 to 17 March, automatic, and I am 23.

A hotel in London for two, 10–12 March, four stars or better, free cancellation if you can find it. Then show me recent reviews for the one I pick.

How many Ktemia requests do I have left this month?

How the search tools work

A search is two steps upstream, folded into one tool call:

  1. Call ktemia_search_flights (or hotels, or cars) with the trip details. You get the first page of results and a nextToken.
  2. Call the same tool again with only nextToken to get the next page. When nextToken is absent, that was the last page.

Tokens are opaque and expire one hour after the search starts. If a token expires, start a new search rather than retrying it.

Hotel and car searches need a location id from ktemia_lookup — the locationId field of a result, which is a numeric string like 29230, not a city name. Flight searches take IATA codes from the code field instead, such as LHR for Heathrow or LON for every London airport.

ktemia_get_details expands one result into every price and booking link. Search pages carry only the leading offers, so this is the call that answers "where do I actually book this".

Quota

Every tool call is one request against your plan's monthly quota, with one exception: ktemia_key_status is free and keeps answering after the quota is spent, which is how an agent diagnoses a QUOTA_EXCEEDED error without making it worse.

A search costs at least two requests — one to start it, one per page read — so budget accordingly. The quota is shared across every key on an account, so creating a second key does not raise the limit.

Two different errors both arrive as HTTP 429, and they mean opposite things:

CodeMeaningWhat to do
RATE_LIMIT_EXCEEDEDToo many requests per secondWait for Retry-After, then retry
QUOTA_EXCEEDEDThe month's allowance is goneStop. Retrying cannot help.

Limits per plan are on pricing.

Security

  • The key is read from KTEMIA_API_KEY and sent only as the X-API-Key header, over HTTPS, to https://api.ktemia.com.
  • The key is never a tool parameter. An agent should never ask you to paste it into a tool call, and the server never exposes it in a result.
  • A KTEMIA_API_URL override must be https:// (or localhost, for development), and redirects are refused, so the key cannot be sent to another host.
  • Upstream calls carry X-Ktemia-Client: mcp/ , so MCP traffic is distinguishable from direct API traffic in Ktemia's own logs.
  • Every tool is read-only. Nothing here books, pays, holds, or cancels anything.

Consider using a separate key for your editor, so you can revoke it without touching a production integration. The quota is per account, so a second key costs you nothing in allowance.

A note on the hosted server

A hosted server at mcp.ktemia.com is planned, and it will accept your API key and forward it to api.ktemia.com. The MCP security guidance names that shape "token passthrough" and advises against it, so it is worth being explicit about why it is acceptable here: the guidance targets OAuth audience confusion, where a server accepts a token minted for a different service and deceives a third-party resource server into trusting it. A Ktemia key is first-party, the MCP server is Ktemia, and the quota and rate limits live on that same key upstream — one audience, no third party, and no control bypassed. If that changes, OAuth 2.1 is the migration, and the credential source is a single seam in the code so it will not ripple into the tools.

Until then, run it locally over stdio as above.

Self-host and develop

git clone https://github.com/Ktemiaa/ktemia-mcp.git

cd ktemia-mcp

TypeScript

cd typescript

npm install npm run build npm test

Python

cd python

uv sync # also copies spec/tools.json into the package uv run pytest

Point your client at whichever you built:

{

"mcpServers": { "ktemia": { "command": "node", "args": ["/absolute/path/to/ktemia-mcp/typescript/dist/index.js"], "env": { "KTEMIA_API_KEY": "your-key" } } } }

For Python, "command": "uv" with "args": ["--directory", "/absolute/path/to/ktemia-mcp/python", "run", "ktemia-mcp"].

Layout
spec/tools.json   shared tool contract: names, descriptions, enums, defaults

typescript/ the npm package, @ktemia/mcp python/ the PyPI package, ktemia-mcp

Tool names, descriptions, enums, and defaults live in spec/tools.json, which both implementations read. The descriptions are what steer an agent — text like "a guessed city searches the wrong trip and spends quota" is what stops it inventing a departure airport — so they are written once rather than copied, since prose that drifts between two packages would change agent behaviour with nothing in any log to show why.

Each package copies that file in at build time, because neither npm nor a Python wheel can include a file from outside its own directory. typescript/scripts/sync-spec.mjs and python/hatch_build.py do that, and CI asserts both copies are byte-identical to the original.

Tests

TypeScript

npm test          # offline, deterministic, no key needed

npm run test:live # opt-in, spends real quota

Python

uv run pytest                      # offline; the live tests skip themselves

KTEMIA_API_KEY=your-key uv run pytest tests/test_live.py uv run python scripts/smoke_wheel.py # checks an installed build can start

The offline suites stub the transport, so they cover what production cannot reach on demand — a spent quota, a rate limit, a timeout, a malformed upstream body — and assert that a missing required field is refused locally without an upstream call, so a guessed search cannot cost you a request.

python/tests/test_parity.py is the one that keeps the packages honest: it asserts both register the same seven tools in the same order, that every description contains the shared spec's prose verbatim, that every metered tool says so and ktemia_key_status does not, and that no numeric parameter advertises an absurd bound.

The live suites run only

只显示了开头部分;其余内容请在仓库中阅读