Georgia MCP

概要

ジョージアの公共データは、国立銀行、各商業銀行、各燃料会社、トビリシ交通会社など、多くのサイトに分散しています。Georgia MCPはそれらの情報をモデル向けに取得し、1つの質問に対して1つの回答を返します。

• 読み取り専用。 すべてのツールは公開データを読み取るだけで、何も変更しません。
• 出典を明記。 すべての回答に出典とデータの時点が示されるため、確認できます。
• 正確。 為替レートや価格は、小数文字列で返され、丸めた浮動小数点数にはなりません。
• アカウント不要。 ホスト型サーバーはサインインもキーも必要ありません。

質問できること

今日の米ドルからジョージア・ラリへの公式為替レートはいくらですか？

現在、ユーロを最も有利なレートで買い取っている銀行はどこですか？

ジョージアでディーゼルが最も安い場所はどこですか？

次のバスはいつ私の停留所に到着しますか？

レストランで割引を受けられるTBC Bankカードの特典はどれですか？

対象	情報源
為替レート	ジョージア国立銀行、Bank of Georgia、TBC Bank、Liberty Bank、Terabank、Halyk Bank、Basisbank、Credo Bank、Rico Credit、Scapp、MJC、Inteli Express、MBC、Crystal、Kursi.ge
燃料価格	SOCAR、Wissol、Gulf、Rompetrol、Lukoil、Portal、Connect、Neogas
カード特典	Bank of Georgia、TBC Bank、Liberty Studio
トビリシの公共交通機関	Tbilisi Transport Company
郵便番号	Georgian Post
映画館	Cavea
統計とインフレ	Geostat

インストール

ホスト型サーバーは次の場所で稼働しています。

https://geo-mcp.abgeo.cloud/mcp

Claude

Claude ディレクトリの Georgia MCPを開き、 Connectを選択します。claude.ai、Claude Desktop、Claude モバイルアプリで利用できるようになります。

Claude Code

claude.ai で Georgia MCP を追加している場合、同じアカウントの Claude Code にもすでに追加されています。/mcp を実行して確認してください。claude.ai Georgia MCP として表示されます。自分で追加する場合（API キーでサインインするときなど）は、次を実行します。

claude mcp add --transport http georgia-mcp https://geo-mcp.abgeo.cloud/mcp

ChatGPT

Pluginsを開き、+を選択してから、Add custom MCP serverを選択します。上記のアドレスを貼り付け、認証をNoneに設定します。カスタムサーバーの利用には有料プランが必要です。

Cursor

~/.cursor/mcp.json に次を追加します。

{
  "mcpServers": {
    "georgia-mcp": { "url": "https://geo-mcp.abgeo.cloud/mcp" }
  }
}

VS Code

プロジェクトの .vscode/mcp.json に次を追加します。

{
  "servers": {
    "georgia-mcp": { "type": "http", "url": "https://geo-mcp.abgeo.cloud/mcp" }
  }
}

自分で実行する

Docker を使う場合：

docker run -p 8080:8080 ghcr.io/abgeo/georgia-mcp

次に、クライアントを http://localhost:8080/mcp に接続します。

リリースバイナリを stdio 経由で使う場合：お使いのシステム用のアーカイブを最新リリースからダウンロードして展開し、georgia-mcp を PATH に追加します。その後、次を実行します。

claude mcp add georgia-mcp -- georgia-mcp stdio

各リリースでは、checksums.txt に cosign で署名し、ビルドの来歴情報を付与しています。各検証では、このリポジトリのワークフローがタグからファイルをビルドしたことも確認できます。アーカイブを検証するには、次を実行します。

gh attestation verify georgia-mcp_<version>_linux_amd64.tar.gz --owner ABGEO \
  --signer-workflow ABGEO/georgia-mcp/.github/workflows/release.yml

または、cosignでチェックサムを確認してから、アーカイブを確認します。

cosign verify-blob checksums.txt --bundle checksums.txt.sigstore.json \
  --certificate-identity "https://github.com/ABGEO/georgia-mcp/.github/workflows/release.yml@refs/tags/v<version>" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com
sha256sum --ignore-missing -c checksums.txt

イメージを検証するには：

cosign verify ghcr.io/abgeo/georgia-mcp:<version> \
  --certificate-identity "https://github.com/ABGEO/georgia-mcp/.github/workflows/images.yml@refs/tags/v<version>" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

各アーカイブと各イメージには SPDX SBOM が付属しています。

Go を使い、stdio 経由で実行する場合：

go install github.com/abgeo/georgia-mcp/cmd/georgia-mcp@latest
claude mcp add georgia-mcp -- georgia-mcp stdio

キーが必要なソースは 3 つあるため、デフォルトでは無効になっています。有効にするには、スイッチを true に設定し、キーを指定します。

ソース	スイッチ	キー
Tbilisi Transport Company	GEOMCP_TRANSIT_TTC_ENABLED	GEOMCP_TRANSIT_TTC_API_KEY
TBC Bank developer API	GEOMCP_RATES_TBC_ENABLED	GEOMCP_RATES_TBC_API_KEY
Credo Bank rates API	GEOMCP_RATES_CREDO_ENABLED	GEOMCP_RATES_CREDO_API_KEY

configs/.env.example にすべての設定が記載されています。

ツール

ツール	内容
rates_get_official_rates	今日または過去の日付におけるラリの公式為替レート。
rates_list_official_history	期間中の各日における1通貨の公式為替レート。
rates_get_commercial_rates	現在の商業銀行の買いレートと売りレート。
fuel_get_prices	グレード別にまとめた、各社の本日の燃料価格。
offers_search_offers	銀行の現在のカード特典。
offers_get_offer	1つのカード特典の詳細な条件。
transit_search_stops	名前またはコードによるトビリシの停留所。
transit_list_nearby_stops	ある地点の近くにある停留所。近い順に表示します。
transit_list_arrivals	停留所に次に到着する車両。リアルタイム情報です。
transit_search_routes	番号または名前によるトビリシの路線。
transit_get_route	各方向とすべての停留所を含む1つの路線。
transit_get_timetable	ある停留所から出発する路線の予定時刻。
transit_search_places	名前または住所によるトビリシの場所。
transit_plan_trip	トビリシ内の2地点間を公共交通機関で移動する経路。
postal_search_codes	住所、通り、町、または村の郵便番号。
cinema_list_cinemas	Caveaの営業中の映画館。
cinema_list_movies	Caveaで上映中または近日公開予定の映画。
cinema_search_movies	英語タイトルの一部で検索したCaveaの映画。
cinema_list_sessions	ある日の上映回。料金と空席状況を含みます。
cinema_get_seat_map	ある上映回の座席。各クラスの空席を含みます。
stats_search_tables	タイトルまたはフォルダー内の語句で検索したGeostatの統計表。
stats_get_table	次元とその値を含むGeostatの統計表。
stats_get_cells	選択した条件におけるGeostatの統計表の数値。
stats_get_inflation	月、都市、価格グループ別のジョージアのインフレ率。
air_get_quality	都市、測定局、または全測定局の最新の大気質測定値。
air_list_history	1つの測定局における、最長7日分の時間別大気質測定値。

ウェブサイトでは、各ツールの入力例と実際の出力を確認できます。

開発

Georgia MCPでは、仕様駆動開発を採用しています。コードは docs/specs/内のドキュメントに基づいています。プルリクエストを作成する前に、このガイドをお読みください。

Go（go.modに記載されたバージョン）とTaskが必要です。

cp configs/.env.example .env  # then fill in the keys
task run                      # serve over HTTP on :8080
task lint test build          # check the server
task test:live                # run the tests against the real sources

各ベンダーのクライアントはpkg/<vendor>の下にあるパッケージで、別のプロジェクトからインポートできます。task --listですべてのタスクを確認できます。

コントリビューション

バグ報告やアイデアはissuesで、 質問はQ&Aで歓迎しています。 ソースやツールを追加する場合は、まずissueを作成してください。それぞれ、要件ドキュメントから始まります。 プルリクエストを作成する前に、コントリビューションガイドをお読みください。

プライバシーとセキュリティ

ホスト型サーバーはアクセスログと各ツール呼び出しの記録を保持しますが、呼び出しの入力は記録しません。プライバシーポリシーと 利用規約をご確認ください。

脆弱性を報告するには、セキュリティポリシーに従ってください。公開のイシューは作成しないでください。

免責事項

Georgia MCPは公式サービスではありません。ジョージア国立銀行や、データを参照する銀行、燃料会社、交通事業者、郵便事業者、映画館チェーン、統計局とは提携していません。データの所有権は各提供元にあり、遅延や誤りがある場合があります。判断する前に提供元にご確認ください。

作者

Temuri Takalandze (ABGEO)がジョージアで❤️を込めて作成しました。

ライセンス

Georgia MCPは、GNU General Public License v3.0に基づくフリーソフトウェアです。