Georgia MCP

为什么选择它

格鲁吉亚的公共数据分散在许多网站上：国家银行、各家商业银行、各家燃油公司以及第比利斯交通公司。Georgia MCP 为你的模型读取这些数据，让你只需提出一个问题，就能得到一个答案。

• 只读。 每个工具都只读取公共数据，不会进行任何更改。
• 有来源。 每个答案都会标明数据来源和时间，方便你核实。
• 精确。 汇率或价格均以十进制字符串表示，绝不会四舍五入为浮点数。
• 无需账户。 托管服务无需登录，也无需密钥。

可以询问什么

今天美元兑拉里的官方汇率是多少？

目前哪家银行的欧元买入价最高？

格鲁吉亚哪里可以买到最便宜的柴油？

下一班公交车什么时候到我的站点？

哪些 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
第比利斯公共交通	第比利斯交通公司
邮政编码	格鲁吉亚邮政
电影院	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

每个发布版本都会使用 cosign 对 checksums.txt 签名，并附带构建来源证明。每项检查还会证明此仓库的工作流是从该标签构建文件的。要检查压缩包，请运行：

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

有三个数据源需要密钥，因此默认关闭。要启用其中一个，请将其开关设为 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 列出了所有设置。

工具

Tool	回答内容
rates_get_official_rates	今天或过去某日的拉里官方汇率。
rates_list_official_history	某一货币在一段时期内每天的官方汇率。
rates_get_commercial_rates	商业银行当前的买入和卖出汇率。
fuel_get_prices	各公司的今日燃油价格，按等级分组。
offers_search_offers	银行当前的银行卡优惠。
offers_get_offer	某项银行卡优惠的完整条款。
transit_search_stops	按名称或代码查询第比利斯的站点。
transit_list_nearby_stops	某个地点附近的站点，按距离从近到远排列。
transit_list_arrivals	某个站点即将到达的车辆实时信息。
transit_search_routes	按编号或名称查询第比利斯的线路。
transit_get_route	某条线路的各个方向及所有站点。
transit_get_timetable	某条线路从某个站点出发的计划班次。
transit_search_places	按名称或地址查询第比利斯的地点。
transit_plan_trip	规划第比利斯两地之间的公共交通行程。
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	某个监测站最多 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 发布的自由软件。