mcp-turkiye

mcp-turkiye

トルコの公共データを、1つのMCPサーバーで。 Claude、Cursor、VS Code、Codex、およびMCPに対応するあらゆるアシスタント向け：トルコ共和国中央銀行の為替レート、中央銀行のEVDS統計（インフレ、金利、40,000以上の系列）、BISTの日次価格、暗号資産のトルコリラ価格、AFADとKandilliの地震カタログ、MGMの天気と警報、燃料価格、イスタンブールのリアルタイム交通指数、当番薬局（イスタンブール、イズミル）、İSPARKの駐車場混雑状況、イスタンブールの大気質、Metro İstanbulの路線／駅／お知らせ、イズミルESHOTのバス運行状況と市場価格、イスタンブール／イズミル／コンヤ／ガズィアンテプのオープンデータポータル、官報の索引と本文、mevzuat.gov.trでの法律／規則の検索と条項ごとの現行本文、祝日、ÖSYMの試験日程、公式パラメーター（最低賃金、SGKの下限／上限）、81県と973地区の人口／面積／ナンバープレート情報、AAとTRTのニュース見出し、TCKN／VKN／IBANの形式検証に対応しています。すべての回答に情報源と取得時刻が含まれます。

トルコの公共データを1つのMCPサーバーで：中央銀行の為替レート、中央銀行のEVDS統計サービス（インフレ、金利、40,000以上の系列）、Borsa İstanbulの日次価格、暗号資産のリラ価格、国立およびKandilliの地震カタログ、国立気象サービスの観測値、予報、警報、地区別の燃料価格、イスタンブールのリアルタイム交通指数、当番薬局（イスタンブール、イズミル）、İSPARKの駐車場混雑状況、イスタンブールの大気質、Metro İstanbulの路線／駅／お知らせ、イズミルのリアルタイムバス運行状況と卸売食品価格、イスタンブール／イズミル／コンヤ／ガズィアンテプのオープンデータポータル（検索、データセット、DataStoreの行）、官報の日次索引と記事本文、mevzuat.gov.trの統合法令検索と条項ごとの本文、祝日、全国試験日程、公式年次数値（最低賃金、社会保障の下限／上限）、県と地区のプロフィール、AA／TRTの見出し、オフラインでのID／税番号／IBANのチェックサム検証に対応しています。すべての回答に情報源と取得時刻が含まれます。

独立したプロジェクトです。 mcp-turkiyeは、いかなる公的機関の公式サービスでもありません。MITライセンスの対象はコードのみです。各データソースにはそれぞれ独自の利用規約があり（SOURCES.md）、サーバーの利用には許容される利用ポリシーが適用されます。

インストール

Node.js 20+ があれば十分です。ほかにインストールするものはありません。キーが必要なのは TCMB EVDS ツールのみです（無料。下記参照）。それ以外はすべてキーなしで動作します。

Claude Code

claude mcp add turkiye -- npx -y mcp-turkiye

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "turkiye": { "command": "npx", "args": ["-y", "mcp-turkiye"] }
  }
}

Cursor / VS Code — .cursor/mcp.json または .vscode/mcp.json：

{
  "mcpServers": {
    "turkiye": { "command": "npx", "args": ["-y", "mcp-turkiye"] }
  }
}

Cline — MCP の設定で同じ mcpServers エントリーを使います。Cline 自身にインストールさせるための手順はこちらです：llms-install.md。

その後、アシスタントにトルコ語で質問します：

「今日の TCMB のドル売りレートはいくらですか。どの公報の情報ですか？」 「年間インフレ率はいくらですか。政策金利はいくらですか。最後に発表された月はいつですか？」 「直近3日間にマグニチュード4を超える地震はありましたか？」 「Kadıköy の天気はどうですか。週末に雨は降りますか？」 「今日、気象警報は出ていますか。Ankara は対象ですか？」 「Kandilli によると、直近24時間にマグニチュード3を超える地震は何件ありましたか？」 「KPSS の結果はいつ発表されますか。ALES/3 の申し込みはいつですか？」 「Bornova の軽油はいくらですか？」 「İBB のオープンデータに駐車場のデータはありますか。テーブルを表示してください。」 「今日の Resmî Gazete でどの規則が公布されましたか。最初のものを要約してください。」 「KVKK の第6条には何と書かれていますか。要配慮個人データとは何ですか？」 「2026年の最低賃金の手取りはいくらですか。SGK の上限はいくらですか。どの法律に基づいていますか？」 「労働法の予告期間は何条に規定されていますか。何週間ですか？」 「THYAO は直近1か月でどう動きましたか。BIST 100 と比べてどうですか？」 「年間インフレ率は直近8か月でどのように推移しましたか？」(EVDS キーが必要です) 「İstanbul の現在の交通状況はどうですか？」 「2026年10月29日は何曜日ですか。営業日ですか？」 「TR33 0006 1005 1978 6457 8413 26 は有効な IBAN ですか。どの銀行のものですか？」

リモートサーバー（Docker）

各マシンにインストールする代わりに、サーバーを一度クラウドに配置し、クライアントを URL で接続できます。各リリースでイメージが ghcr.io/berkantacun/mcp-turkiye に公開されます。組み込みの Streamable HTTP エントリーポイント（dist/http.js）は、同じツールと同じエンベロープを /mcp パスで提供します。ステートレス（セッション ID なし）のため、複数のインスタンスの背後でも動作します。

docker run -p 8080:8080 -e MCP_TURKIYE_API_KEY=<gizli-anahtar> ghcr.io/berkantacun/mcp-turkiye
claude mcp add --transport http turkiye http://localhost:8080/mcp --header "X-API-Key: <gizli-anahtar>"

Docker を使わない場合：npm run build && HOST=127.0.0.1 PORT=8080 node dist/http.js（ローカルで自分のマシンからのみアクセスできるように、127.0.0.1 を指定します）。

環境変数	デフォルト	説明
PORT	8080	リッスンするポート
HOST	0.0.0.0	リッスンするアドレス。IPv6 が利用できない環境（Azure Container Apps）では :: は動作しません
MCP_TURKIYE_API_KEY	—	設定すると、すべての /mcp リクエストに X-API-Key ヘッダーが必要になります。ない場合は 401 を返します。旧名の MCP_PROXY_API_KEY も有効です
MCP_TURKIYE_RATE_LIMIT	60	IP ごとの1分あたりのリクエスト上限。超過すると 429 と Retry-After を返します。0 で無効になります
TRUST_PROXY	—	1 の場合、クライアント IP を X-Forwarded-For の右端のエントリーから読み取ります。信頼できるリバースプロキシの背後にある場合のみ有効にしてください
MCP_TURKIYE_ALLOWED_ORIGINS	—	ブラウザーからの呼び出しを許可するオリジン。カンマ区切り（すべて許可する場合は *）。Origin ヘッダーを含み、リストにないリクエストは 403 を返します。MCP クライアントはこのヘッダーを送信しませんが、ブラウザーは送信します（DNS リバインディングを含む）

• GET /health はキー不要で 200 を返し、レート制限の対象になりません。ヘルスチェックに使用します。
• リクエストボディが1 MBを超える場合は 413 を返します。SIGTERM を受信すると、サーバーは新しい接続の受付を停止し、処理中のリクエストを完了させてから終了します（最長10秒）。
• 公開エンドポイントでキーなしのまま実行しないでください。サーバーが、あなたに代わって公的機関へリクエストを送信するオープンプロキシになります。
• レート制限はメモリ内で管理され、インスタンスごとに適用されます。複数のインスタンスでは、全体の上限はインスタンス数に比例して増加します。
• Konya のオープンデータポータルは、トルコ国外の IP を拒否します。国外リージョンのクラウドでは、Konya 向けの acikveri_* ツールはエラーを返しますが、ほかのソースは動作します（Azure Container Apps の Germany West Central で確認済み）。

claude.ai / Claude Desktop にリモートサーバーとして接続する

Claude Desktop で1台のマシンを使う場合は、上記のローカルインストール（npx）で十分です。リモートコネクターは、claude.ai（ウェブ、モバイル）でサーバーを使う場合や、各マシンにインストールせずに使う場合のためのものです。このプロジェクトは公開エンドポイントを運用していません。まず、上記のイメージを使ってご自身のサーバーをセットアップする必要があります。

前提条件（Anthropic のドキュメント）：

• サーバーは HTTPS でパブリックインターネットからアクセスできる必要があります。接続はお使いのマシンではなく、Anthropic のサーバーから確立されます。Claude Desktop でも同様です。Anthropic の送信元 IP 範囲は 160.79.104.0/21 です（IP アドレス）。ファイアウォールでこの範囲を許可してください。
• アドレスは https://<alan-adınız>/mcp の形式で、トランスポートは Streamable HTTP です。

追加方法：

• Free、Pro、Max： カスタマイズ → コネクター → カスタムコネクターを追加を選び、名前と URL を入力します。
• Team、Enterprise： オーナーが組織の設定 → コネクター → 追加 → カスタム → ウェブから追加します。メンバーはカスタマイズ → コネクターで接続を選択します。
• チャットの**＋ → コネクター**メニューからコネクターのオン／オフを切り替えられます。

キー（MCP_TURKIYE_API_KEY）：

• 追加ウィンドウにリクエストヘッダーセクションがある場合：認証でサインインなしを選択し、ヘッダーとしてリストから x-api-key を選び、値にキーをそのまま入力します。この機能はベータ版で、一部の組織でのみ有効になっています。
• セクションがない場合、Claude は X-API-Key を送信できず、キーが必要なサーバーはすべてのリクエストに 401 を返します。キーを無効にすると、サーバーは公開プロキシになります（上記の警告を参照）。この場合は、Claude Desktop でローカルインストールを使用してください。キーなしで実行する場合は、少なくともファイアウォールで 160.79.104.0/21 のみを許可してください。この範囲はすべての Claude ユーザーのコネクター通信に使われるため、URL を知っている別の Claude ユーザーも接続できます。
• 認証設定は追加後に変更できません。キーを変更した場合は、コネクターを削除して再追加してください。

知っておくべきこと：

• Claude からのすべてのリクエストは Anthropic の送信元アドレスから届くため、IP ごとのレート制限はこれらのアドレスで共有されます。複数のユーザーがいる組織では、MCP_TURKIYE_RATE_LIMIT を引き上げる必要がある場合があります。サーバーがリバースプロキシの背後にある場合は TRUST_PROXY=1 を設定してください。設定しないと、すべてのリクエストがプロキシのアドレスから来たものとして扱われます。
• claude.ai と Desktop では、ツール呼び出しの最大実行時間は 240 秒で、ツールの結果は約 150.000 文字に制限されています（技術的な制限）。
• ご自身のマシン上でのみ実行されている（127.0.0.1、localhost）サーバーは claude.ai に接続できません。Anthropic のサーバーからアクセスできないためです。Claude Code はご自身のマシンから接続を確立するため、ローカルサーバーには上記の claude mcp add --transport http コマンドを使用してください。

ツール

ツール	機能	情報源
tcmb_kurlar	当日（または指定日の）TCMB 指標為替レート速報。全通貨を掲載	TCMB
tcmb_kur	単一通貨の為替レート — birim フィールドに注意。JPY は 100 単位で提供されます	TCMB
evds_kategoriler	EVDS のトピックツリー（物価、金利、為替、国際収支、調査、住宅など）	TCMB EVDS*
evds_veri_gruplari	カテゴリ内のデータグループ：コード、頻度、単位、期間	TCMB EVDS*
evds_seriler	データグループ内の系列。名前で絞り込み可能	TCMB EVDS*
evds_seri	1 つまたは複数の系列の観測値。計算式（前年比など）、頻度、集計オプションを指定可能	TCMB EVDS*
evds_gosterge	コードが分からなくても名前で主要指標を検索：年間／月間インフレ率、PPI、政策金利、ドル／ユーロ／ポンド、住宅価格指数、実質実効為替レート。最新値と日付を表示	TCMB EVDS*
bist_hisse	株式の日次終値履歴（終値、加重平均価格、最安値／最高値、出来高、時価総額）＋同日の BIST 100 と USD/TRY	İş Yatırım
btcturk_kripto	暗号資産のリアルタイム TL（または USDT）価格：最新値、買値／売値、日次変動、出来高。シンボル一覧または出来高上位 30 件	BtcTurk
afad_depremler	期間、最小マグニチュード、件数上限を指定した地震一覧。新しい順	AFAD
kandilli_depremler	Kandilli 天文台の最新地震 — AFAD とは独立した第 2 のカタログ。ML/Mw/MD、速報値／改訂値	Kandilli
mgm_hava_durumu	県／地区のリアルタイム観測（気温、体感温度、湿度、風、気圧、気象状況）＋5 日間予報	MGM
mgm_uyarilar	発令中の気象警報（大雨、暴風、降雪など）を全文表示。il で絞り込み	MGM
opet_akaryakit	地区ごとのガソリン／ディーゼル／灯油／重油の給油価格。イスタンブールは欧州側とアジア側に対応	Opet
ibb_trafik_indeksi	イスタンブール全域のリアルタイム交通渋滞度（0～100）。呼び出しごとに最新情報を取得	İBB
ibb_nobetci_eczane	イスタンブールの本日の当番薬局：名称、地区、住所、電話番号、位置。ilce で絞り込み	İBB
ibb_otopark	İSPARK 駐車場のリアルタイム空き状況／混雑度。地区、名称、または座標から近い順に検索	İBB
ibb_otopark_detay	İSPARK 駐車場の料金、住所、月額定期利用料	İBB
ibb_hava_kalitesi	28 観測所の AQI、主要汚染物質、PM10/SO2/O3/NO2/CO。1 観測所の 24 時間系列にも対応	İBB
ibb_metro	Metro İstanbul の路線（始発／終電）と、路線ごとの駅一覧（エレベーター、トイレなど）	İBB
ibb_metro_duyurular	Metro İstanbul の乗客向けお知らせ：障害、運行変更、駅の閉鎖	İBB
izmir_nobetci_eczane	イズミルの本日の当番薬局。地域別	İzmir BB
izmir_hal_fiyatlari	イズミル卸売市場の青果／魚介類の日次価格（最低、最高、平均）	İzmir BB
izmir_otobus	ESHOT の停留所に接近中のバスをリアルタイム表示：路線、残り停留所数、位置	İzmir BB
acikveri_ara	İBB、イズミル、コンヤ、またはガズィアンテプのオープンデータポータルでデータセットを検索	4 自治体
acikveri_veriseti	データセットの詳細：ライセンス、ファイル、ダウンロードリンク、テーブルサービスの有無	4 自治体
acikveri_kayitlar	テーブルサービスが有効なデータソースの列と行（DataStore）。ページネーションとテキストフィルターに対応	4 自治体
resmi_gazete_fihrist	当日の官報目次：号数、セクション／種別、項目の見出しとリンク	Resmî Gazete
resmi_gazete_metin	項目（規則、通達、決定）のプレーンテキスト。2 万文字単位に分割	Resmî Gazete
mevzuat_ara	法律、法令、規則、通達、大統領決定／大統領令／大統領回状を検索（見出しまたは全文）	mevzuat.gov.tr
mevzuat_metin	法令の公式な最新（統合）全文。条文一覧付きで分割表示	mevzuat.gov.tr
mevzuat_madde	単一の条文：6、6/A、ek 1、geçici 3 — 見出しも表示	mevzuat.gov.tr
resmi_tatiller	年間の祝日：国民の祝日＋宗務庁の暦に基づく宗教祝日（前日の半日も含む）	なし
tatil_mi	指定日が週末、祝日、または営業日かどうか	なし
osym_sinav_takvimi	ÖSYM の試験日程：YKS、KPSS、ALES、YDS、DGS、TUS などの出願、試験、結果、志望登録の日程。既定では今後の予定のみ	ÖSYM
resmi_parametreler	出典付きの年間公式数値：最低賃金（日額／月額の総額、手取り）、SGK 保険料算定対象賃金の下限／上限	なし
il_bilgisi	県の人口、面積、標高、ナンバープレートコードと市外局番、地域、人口順の地区	なし
ilce_ara	地区名から県、人口、面積を検索。同名の地区をすべて表示	なし
iller_listesi	81 県を人口／面積／ナンバープレートコード順に並べ、地域で絞り込み	なし
dogrula_tckn	トルコ共和国 ID 番号のチェック桁を検証	なし
dogrula_vkn	納税者番号のチェック桁を検証	なし
dogrula_iban	TR IBAN の mod-97 検証＋銀行コード	なし
plaka_il	ナンバープレートコード ↔ 県。81 県に対応	なし
haber_basliklari	AA または TRT Haber の最新ニュース：見出し、概要、リンク、時刻。カテゴリと検索フィルターに対応	AA、TRT
* EVDS ツールを使うには、無料の個人用キーが必要です。詳しくはTCMB EVDS キーをご覧ください。キーがない場合、この5つのツールは取得方法を案内するエラーを返し、ほかのツールには影響しません。

検証ツールが検証するのは形式のみです。チェックディジットは計算しますが、いかなる機関にも問い合わせず、番号がこのマシンから送信されることもありません。「有効」な番号であっても、実在の人物や機関に属することを意味するわけではありません。どの応答でもこの点を明示します。

定義済みの質問（プロンプト）

クライアントではスラッシュコマンドまたはメニューとして表示されます。

プロンプト	内容
gunun_ozeti	為替、地震、天気、交通、官報の見出しをまとめて取得し、10行の日次サマリーを作成します（ilは任意です）
mevzuat_sorusu	法律に関する質問に対し、mevzuat.gov.trの本文から該当条文を取得して引用し、出典を添えて回答します

TCMB EVDS キー

EVDSは中央銀行の統計サービスです（CPI、政策金利、為替レート、住宅価格指数、国際収支、調査など、4万件を超える系列）。利用には無料の個人用キーが必要です。

1. https://evds3.tcmb.gov.tr → マイページ → 登録（メールアドレスの確認が必要です）。
2. ログインしたら、ユーザー名の下にあるプロフィールをクリックします。
3. ページ下部のAPIキーをコピーボタンを押します。

MCP の設定で、キーを環境変数として指定します。

{
  "mcpServers": {
    "turkiye": {
      "command": "npx",
      "args": ["-y", "mcp-turkiye"],
      "env": { "EVDS_API_KEY": "anahtarınız" }
    }
  }
}

キーはEVDSリクエストのkeyヘッダーでのみ使用され、応答、ログ、URLには含まれません。EVDSでは1回のリクエストにつき最大150件の観測値が返されます。より長い期間を取得するには、複数回呼び出す必要があります。

すべての応答はエンベロープに含まれます

{
  "kaynak": { "id": "tcmb", "ad": "Türkiye Cumhuriyet Merkez Bankası", "url": "https://www.tcmb.gov.tr/kurlar/today.xml" },
  "alindi": "2026-09-16T13:40:12.000Z",
  "veri": { "tarih": "2026-09-16", "bultenNo": "2026/174", "kur": { "kod": "USD", "dovizSatis": 48.6654, "birim": 1 } }
}

kaynakはデータの提供元となる機関と完全なURL、alindiはデータを取得した時刻です。為替レートや地震の一覧に日付を付けずに表示すると、「時間に依存しない事実」のように受け取られるおそれがあります。エンベロープによってそれを防ぎます。提供元が応答しない場合、ツールはエラーを返します。推定値を生成することは決してなく、どの機関が応答しなかったかを伝えます。

設計上の決定

• すべての応答はリアルタイムです。 パッケージにデータを埋め込んでいません（祝日カレンダー、ナンバープレートの表、出典付きで埋め込まれた公式パラメーターを除く）。各ツールは呼び出された時点で機関からデータを取得します。キャッシュは機関の負荷を抑えるためだけに短時間使用します。交通指数は1分、地震は1分、為替レートは5分、天気は10分、燃料価格は30分です。alindiフィールドでデータの正確な取得時刻を確認できます。
• キーも登録も不要です。 すべての提供元は公開されており、キーも必要ありません。無料キーが必要な提供元（TCMB EVDSなど）を追加する場合は任意とし、キーなしで動作するツールは引き続きキー不要で使えるようにします。
• 公共サーバーに負荷をかけません。 すべてのリクエストにタイムアウトを設定し、5xxでは1回再試行しますが、4xxでは再試行しません。同じURLは短時間キャッシュします。前日分の公報は内容が変わらないため1日間、当日分は5分間キャッシュします。
• 提供元に変更があれば検知します。 各提供元の実際のエンドポイントに対して、週次の契約テストを実行します（npm run test:live）。形式が変わるとCIが失敗し、ユーザーのアシスタントが誤った回答をする前に検知できます。
• 個人データは扱いません。 NVIの本人確認、e-Nabız、e-Devletのように、ログインや個人データが必要な提供元はありません。今後追加することもありません。
• 自分たちの対策です。 このリポジトリのクライアント設定例は、すべてのCI実行でguardmcpによるスキャンを受けます。

ロードマップ

次の候補は、İETTの路線・停留所・運行便（SOAP）、アンカラ／イズミルのダム貯水率、TFFの順位表、EPDKの電気料金、GİBの税務カレンダーです。Diyanetの礼拝時間は公式APIキーが必要なため、保留中です。提供元の追加はフォルダーを1つ追加するだけです。CONTRIBUTING.mdをご覧ください。

開発

npm ci
npm run verify      # typecheck + lint + build + test (kapsama eşiği %80)
npm run test:live   # gerçek kaynaklara karşı sözleşme testleri
npm run dev         # stdio üzerinden sunucuyu çalıştır

English

AI エージェント向けのトルコの公開データを、1 つの MCP サーバーで利用できます。npx -y mcp-turkiye でインストールできます（Node 20 以上。オプションの EVDS ツールを除き、キーは不要です）。現在、44 個のツールを提供しています。中央銀行の為替レート速報（全通貨または特定の通貨、今日または過去の任意の日付）、BtcTurk のリラ建て暗号資産価格のリアルタイム情報、中央銀行の EVDS 統計（トピックツリー、データグループ、系列、前年比などの計算式を使った観測値、およびインフレ率、PPI、政策金利、為替レート、住宅価格指数、実質実効為替レートなど、名称で指定できる主要指標。無料の EVDS_API_KEY が必要）、Borsa İstanbul の日次株価履歴、AFAD の地震カタログ検索と Kandilli Observatory の独立した一覧、任意の県や地区の MGM の現在の気象情報と 5 日間予報、および発令中の悪天候警報、地区別 Opet の給油所価格、イスタンブールのリアルタイム交通指数、イスタンブールとイズミルの本日の当番薬局、座標から近い順に表示する İSPARK 駐車場のリアルタイム空き状況、AQI と汚染物質の測定値を含むイスタンブールの大気質観測所情報、イスタンブールの地下鉄路線、駅、運行案内、イズミルのリアルタイム ESHOT バス情報と青果・魚介類の卸売価格（日次）、イスタンブール、イズミル、コンヤ、ガズィアンテプの CKAN オープンデータ検索・データセット・DataStore アクセス、官報の毎日の目次と記事本文、mevzuat.gov.tr の法令検索、統合版全文、条文単位の検索、Diyanet の宗教祝日の日付を含む祝日情報、営業日の判定、ÖSYM の全国試験カレンダー（大学入試、公務員試験、大学院試験、語学試験）、公式の年間統計（最低賃金と社会保障の下限・上限。それぞれの Resmî Gazete の号または法令を併記）、オフラインで利用できる県・地区の情報（人口、面積、ナンバープレートコード、地域コード、地方区分）、カテゴリ別の AA と TRT の最新見出し、そして国民 ID 番号、納税者番号、IBAN のオフライン検証と県 ↔ ナンバープレートコードの照合です。すべての回答は、提供元機関、正確な URL、取得時刻を含むエンベロープ形式です。提供元から応答がない場合、推測値ではなくツールエラーを返します。ツールの説明は英語とトルコ語の両方で記載されているため、英語対応モデルも正しく利用できます。リモートでホストする場合は、Docker イメージ ghcr.io/berkantacun/mcp-turkiye が、組み込みのステートレスな Streamable HTTP エントリ（node dist/http.js）を /mcp と /health で実行します。MCP_TURKIYE_API_KEY を設定すると、すべてのリクエストで X-API-Key ヘッダーが必要になります。リクエストは IP ごとにレート制限されます（既定では 1 分あたり 60 件）。データライセンス：SOURCES.md。利用条件：ACCEPTABLE_USE.md。

ライセンス

コード：MIT。データ：各データソースの利用条件に従います。SOURCES.md。