Belirli ülkelerden bir ziyaretçi gibi halka açık URL'leri, kaynağı kanıtlamak için imzalı Ed25519 makbuzlarıyla birlikte getirin.
Ayrıca bilinen adı regionfetch/regionfetch, mcp, regionfetch-mcp
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.1
- Son commit
- 1 Eyl 2026
- Lisans
- MIT
Region Fetch MCP nedir?
Belirli ülkelerden bir ziyaretçi gibi halka açık URL'leri, kaynağı kanıtlamak için imzalı Ed25519 makbuzlarıyla birlikte getirin.
Özet, projenin README dosyasından oluşturuldu
Region Fetch MCP sunucusu hakkında
Region Fetch, halka açık HTTPS URL'lerini belirli ülkelerdeki bir ziyaretçinin bakış açısıyla görüntülemenin bir yolunu sunar. Web içeriğini geri getirmek için regionfetch adlı tek bir araç kullanır ve aynı zamanda isteğin kaynağını kanıtlayan imzalı bir Ed25519 makbuzu sağlar. Bu sunucu, web sitelerinin ABD, DE, JP, BR veya IN gibi farklı coğrafi konumlarda nasıl göründüğünü doğrulaması gereken geliştiriciler için tasarlanmıştır.
Sunucu, Node 20.11 veya daha yüksek sürümünü kullanarak stdio üzerinden çalışır. Kullanıcılar npx kullanarak veya ortam değişkenlerini yapılandırarak kurulum yapabilirler. Sürekli kullanım için önerilen wallet modu, bir REGION_FETCH_WALLET_PRIVATE_KEY ve bir REGION_FETCH_MAX_PAYMENT sınırı gerektirir. Test için statik bir imza modu mevcuttur ancak yalnızca tek bir isteğe izin verir. Araç, veri getirme işlemi için hem http hem de browser modlarını destekler.
Neler yapabilirsiniz
- 1Bölgesel web sitesi içeriğini doğrulayınBelirli bir URL'nin Japonya'da bulunan bir kullanıcıya nasıl göründüğünü görmek için istek gönderin.
- 2İstek kaynağını kanıtlayınVerilerin belirli bir ülkeden alındığını onaylamak için imzalı bir makbuz edinin.
- 3Tekli istek uyumluluğunu test edinÖnceden hazırlanmış tek bir yetkilendirme imzası kullanarak tek seferlik bir kontrol gerçekleştirin.
- 4Yanıt bütünlüğünü doğrulayınDönen gövdenin, doğrulama alanı (verification field) kullanılarak imzalı makbuzla eşleşip eşleşmediğini kontrol edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Region Fetch MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleRegion Fetch MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp -- npx -y regionfetch-mcpRegion Fetch MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Region Fetch MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Region Fetch MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","regionfetch-mcp"],"env":{"REGION_FETCH_PAYMENT_SIGNATURE":"<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>","REGION_FETCH_WALLET_PRIVATE_KEY":"<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"}}'Region Fetch MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Region Fetch MCP'yi Codex içine yükleyin
$ codex mcp add mcp --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' -- npx -y regionfetch-mcpRegion Fetch MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "regionfetch-mcp"] [mcp_servers.mcp.env] REGION_FETCH_PAYMENT_SIGNATURE = "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>" REGION_FETCH_WALLET_PRIVATE_KEY = "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
Region Fetch MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' -e 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp npx -- -y regionfetch-mcpRegion Fetch MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Yapılandırma
REGION_FETCH_PAYMENT_SIGNATUREGizliA single pre-made x402 authorization. Funds exactly one request, so this is for one-shot testing only; prefer the wallet key.
REGION_FETCH_WALLET_PRIVATE_KEYGizliPrivate key of a funded Base wallet. The server signs one fresh x402 authorization per tool call. Keep it in the host's env block; it is never a tool argument.
REGION_FETCH_BASE_URLDeployment origin.
REGION_FETCH_MAX_PAYMENTPer-payment ceiling, for example "$0.10". Use "off" to disable the cap.
| Ad | Açıklama | Sunucu |
|---|---|---|
| REGION_FETCH_PAYMENT_SIGNATURE | A single pre-made x402 authorization. Funds exactly one request, so this is for one-shot testing only; prefer the wallet key. | Gizli |
| REGION_FETCH_WALLET_PRIVATE_KEY | Private key of a funded Base wallet. The server signs one fresh x402 authorization per tool call. Keep it in the host's env block; it is never a tool argument. | Gizli |
| REGION_FETCH_BASE_URL | Deployment origin. | |
| REGION_FETCH_MAX_PAYMENT | Per-payment ceiling, for example "$0.10". Use "off" to disable the cap. |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirregionfetch/regionfetch is public and reachablegithub.com/regionfetch/regionfetch ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorregionfetch-mcp names regionfetch/regionfetch as sourcenpmjs.com/package/regionfetch-mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-09-01github.com/regionfetch/regionfetch ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from regionfetch-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok117 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
regionfetch-mcp
MCP server for Region Fetch — fetch a public HTTPS URL as a visitor in a specific country would see it, with a signed Ed25519 receipt proving where the retrieval came from.
Pre-release. Not yet published to npm. Build from source: https://github.com/regionfetch/regionfetch
npx -y regionfetch-mcp
Node 20.11+. stdio transport. Exposes exactly one tool: regionfetch.
Configuration
Wallet mode (recommended)
{
"mcpServers": {
"regionfetch": {
"command": "npx",
"args": ["-y", "regionfetch-mcp"],
"env": {
"REGION_FETCH_BASE_URL": "https://regionfetch.dev",
"REGION_FETCH_WALLET_PRIVATE_KEY": "0x...",
"REGION_FETCH_MAX_PAYMENT": "$0.10"
}
}
}
}
The server signs one fresh x402 authorization per tool call. This is the only configuration that keeps working past the first request.
Static signature (testing only)
"env": { "REGION_FETCH_PAYMENT_SIGNATURE": "<one x402 authorization>" }
One authorization funds one request, so the second tool call will fail. The server says so on stderr at startup. Useful for a one-shot compatibility check, not for a running server.
Wallet mode wins when both are configured.
Environment variables
| Variable | Default | Purpose |
|---|---|---|
REGION_FETCH_BASE_URL |
https://regionfetch.dev |
Deployment origin. A trailing /api is stripped. |
REGION_FETCH_WALLET_PRIVATE_KEY |
— | Funded Base wallet key. Enables wallet mode. |
REGION_FETCH_MAX_PAYMENT |
$0.10 |
Per-payment ceiling. off disables it. |
REGION_FETCH_PAYMENT_SIGNATURE |
— | A single pre-made authorization. |
REGION_FETCH_RPC_URL |
— | RPC endpoint for on-chain reads during payment construction. |
REGION_FETCH_TIMEOUT_MS |
120000 |
Per-request timeout. |
REGION_FETCH_ALLOW_INSECURE_HTTP |
0 |
Permit an http:// base URL. Development only. |
Legacy GEOFETCH_BASE_URL, GEOFETCH_PAYMENT_SIGNATURE, and PAYMENT_SIGNATURE
are still read, with the canonical names taking precedence. Their use is
reported as deprecated on stderr.
The tool
regionfetch — url (https, ≤ 2048 chars), country
(US | DE | JP | BR | IN), mode (http | browser, default http).
Results use the v1 envelope:
{
"status": 200,
"ok": true,
"response": { "data": { "...": "..." }, "receipt": { "...": "..." } },
"verification": { "valid": true, "signatureValid": true, "bodyHashMatches": true }
}
verification is an additive field: the server verifies each receipt against the
deployment's published key and the returned body before handing it to the model.
Consumers reading only status, ok, and response are unaffected.
Non-2xx responses keep the upstream status and JSON body verbatim and set
isError: true. Terminal paid failures (502, 504) keep their signed
receipts — they are the evidence the paid attempt happened.
Security
- Wallet keys and payment authorizations are never accepted as tool arguments, never written to stdout or stderr, and never returned in tool output.
- stdout carries JSON-RPC only; all diagnostics go to stderr through a redacting logger. Tests assert both.
- Only the
toolscapability is advertised. No resources, prompts, or subscriptions are implemented or claimed.
Full documentation: https://github.com/regionfetch/regionfetch
MIT
Region Fetch MCP soruları
Region Fetch MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp -- npx -y regionfetch-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Region Fetch MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Sunucuyu birden fazla istek için nasıl kullanabilirim?
Ortam değişkenlerinde (environment variables) bakiyesi olan bir Base cüzdan özel anahtarı (private key) sağlayarak Wallet modunu kullanabilirsiniz.
Getirme işlemi için hangi ülkeler destekleniyor?
Araç şu anda ABD, DE, JP, BR ve IN ülkelerini desteklemektedir.
Test için tek bir ödeme imzası kullanabilir miyim?
Evet, tek seferlik uyumluluk kontrolleri için statik bir imza kullanabilirsiniz ancak ikinci araç çağrısı başarısız olacaktır.