プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のための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 に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · 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 に、この名前と値を追加

    ヘッダー名X-API-Key
    値<ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsKtemia

  5. 試してみる

    Ktemia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ 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 が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Ktemia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ 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 の AI チャットを Agent モードで開く

  5. 試してみる

    Ktemia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ 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 の AI チャットを Agent モードで開く

  5. 試してみる

    Ktemia を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Ktemia を使っていると言うか、回答に Ktemia のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.ktemia.com/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Ktemia を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

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/週
接続方法
パソコンでもクラウドでも
最新バージョンi
0.1.5
レジストリ公開日i
2026年11月19日
コードの最終更新i
2026年11月19日
最終確認
2026年11月19日
作者
Ktemiaa
パッケージ
npm: @ktemia/mcp
pypi: ktemia-mcp
ウェブサイト
www.ktemia.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。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)がレジストリに届いたのは昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Mu

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

作者:micro成長中★ 4404 か月前更新

クラウドで動く✓ micro.mu

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

冒頭だけを表示しています。続きはリポジトリで読めます