MapleStats MCP について
MapleStats MCPは、AIエージェントやMCPクライアント向けに、カナダの各機関のオープンデータを検索するバイリンガルサーバーです。ツール検索や複数ソースのクエリ計画、再現用コードの生成に対応し、結果には出典情報が付きます。
主な機能
- 01英語またはフランス語でツール検索
- 02Statistics Canada、BoC、CMHCなどのデータにアクセス
- 03複数ソースのクエリ計画
- 04再現可能なスクリプトとワークブックの生成
- 05出典とデータ鮮度の表示
活用シーン
- 01カナダの国勢調査や経済データの検索
- 02複数のデータソースにまたがる質問の計画
- 03生成したRまたはPythonコードでデータを再取得
MCP 対応
MCPクライアントにカナダのオープンデータ用ツールとドキュメントリソースを提供します。ホスト型のリモートサーバーに接続する方法と、stdioでローカル実行する方法があります。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://maplestats-mcp.onrender.com/mcpclaude mcp add --transport http dsanchezp18-maplestats https://maplestats-mcp.onrender.com/mcp{"mcpServers":{"dsanchezp18-maplestats":{"type":"http","url":"https://maplestats-mcp.onrender.com/mcp"}}}Cursor で開く{"servers":{"dsanchezp18-maplestats":{"type":"http","url":"https://maplestats-mcp.onrender.com/mcp"}}}VS Code で開く{"mcpServers":{"dsanchezp18-maplestats":{"type":"http","url":"https://maplestats-mcp.onrender.com/mcp"}}}{"mcpServers":{"dsanchezp18-maplestats":{"serverUrl":"https://maplestats-mcp.onrender.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
MapleStats MCP
カナダのオープンデータに対応する、ひとつの MCP サーバー。
MapleStats MCP は、ひとつのサーバーを通じて AI エージェント(Claude、Cursor、あらゆる MCP クライアント)にカナダのオープンデータへの型付きアクセスを提供します。対象は、Statistics Canada(テーブル、国勢調査、一般公開用ミクロデータ)、Bank of Canada、CMHC、連邦機関、連邦・州・準州・自治体のオープンデータポータルで、英語とフランス語に対応しています。すべての結果にデータソースが付与されます。
MapleStats MCP は、ひとつのサーバーを通じて、AI エージェントにカナダのオープンデータへの構造化されたアクセスを英語とフランス語で提供します。
プロジェクトのビジョン:docs/PROJECT_GUIDE.md。
データソースの対応状況:docs/ROADMAP.md。
ウェブサイト:https://maplestats.danielstats.io/。
最も簡単な方法:エージェントに依頼する
- このプロンプトをコピーします。
- Claude Code、Codex、Cursor、またはコンピューター上でコマンドを実行できるエージェントに貼り付けます。
- エージェントから指示があったら再起動し、データについて質問します。
MapleStats MCP サーバーをこのエージェントに接続してください。https://github.com/dsanchezp18/maplestats-mcp のセットアップ手順に従ってください。
セットアップを行うエージェント向けの手順
デフォルトはホスト型サーバーです。インストールもアカウントもキーも必要ありません。
-
このリモート(HTTP)MCP サーバーを
maplestatsという名前で登録します。- Claude Code:
claude mcp add --transport http --scope user maplestats https://maplestats-mcp.onrender.com/mcp - Codex CLI:
codex mcp add maplestats --url https://maplestats-mcp.onrender.com/mcp - Cursor、Claude Desktop、その他の
mcpServersクライアント: クライアントの設定ファイル(Cursor:~/.cursor/mcp.json、macOS の Claude Desktop:~/Library/Application Support/Claude/claude_desktop_config.json、Windows の Claude Desktop:%APPDATA%\Claude\claude_desktop_config.json)に次のエントリを追加し、既存のサーバーはそのまま残します。 - claude.ai と Claude のスマートフォンアプリ: ウェブで「Settings」→「Connectors」→「Add custom connector」を開き、名前に
MapleStats、アドレスにhttps://maplestats-mcp.onrender.com/mcpを入力します。その後、ウェブまたはスマートフォンアプリのチャットで、ツールメニューから有効にします。デフォルトでは Claude は呼び出しのたびに承認を求めます。すべてのツールは読み取り専用なので、コネクターのツール権限で常に許可するよう設定してください。 - ChatGPT(ウェブ): 「Settings」→「Security and login」→「Developer mode」を有効にし、同じアドレスと「No Authentication」を指定して、リモート MCP サーバー用の開発者モードアプリを作成します。すべてのツールは読み取り専用なので、ChatGPT は呼び出しの確認を求めないはずです。OpenAI はこの機能をウェブ向けに提供しています。
- 組織全体で使う場合: Claude Team または Enterprise では、オーナーが「Organization settings」→「Connectors」→「Add custom connector」で一度追加し、その後、各メンバーが接続します。ChatGPT Business、Enterprise、または Edu では、管理者が「Developer mode」(「Workspace Settings」→「Permissions & Roles」→「Connected Data」)を有効にし、アプリを作成して公開します(「Workspace settings」→「Apps」→「Drafts」→「Publish」)。ホスト型サーバーは共有の無料インスタンスなので、大規模な組織では独自のコピーを実行してください。
- VS Code:
.vscode/mcp.jsonのserversキーの下に、"type": "http"を含む同じエントリを追加します。
{ "mcpServers": { "maplestats": { "url": "https://maplestats-mcp.onrender.com/mcp" } } } - Claude Code:
-
クライアントを再起動または再読み込みするようユーザーに伝え、
search_toolsツールが一覧に表示されていることを確認します。 -
クライアントがリモートサーバーを使えない場合、またはユーザーがマイクロデータ集計ツールを使いたい場合や、すべてを自分のマシンに保持したい場合に限り、ローカルで実行します。
claude mcp add --scope user maplestats -- uvx maplestats-mcpを使います(uv が必要です)。または、他のクライアントでは同等のuvx maplestats-mcpエントリを使います(インストールを参照)。
ホスト型サーバーは無料インスタンスなので、15 分間アクセスがない状態の後に届いた最初のリクエストは、サーバーの起動を待つことになります(計測値は 35 秒、最大 1 分)。クライアントがサーバーを失敗と報告した場合は、1 分後に再試行してください。無料プランの月間稼働時間は使い切ることがあり、その場合は翌月 1 日までエンドポイントが停止します。ローカルインストールには影響しません。各クライアントのリクエスト上限は毎分 60 件で、マイクロデータ集計ツールは無効になっています。エージェントがツールを呼び出すと、検索語句や表番号がサーバーとそのホストである Render に送信されます。コードはこれらをログに記録しませんが、メモリ内キャッシュには、エントリの有効期限が切れるかサーバーが再起動するまで、検索語句やフィルターがキーまたはレスポンスとして保持されることがあります。Render の利用規約とプライバシーポリシーを確認してください。プライバシーを完全に確保するには、ローカルで実行してください。記録される内容については、FAQをご覧ください。その他のクライアントについては、接続ページをご覧ください。
ローカルにインストールする(任意)
お使いのマシンで実行したいですか?アカウントやキーは不要で、stdio 経由で動作します。
uvx maplestats-mcp # run without installing
uv tool install maplestats-mcp # or install the command once (pip works too)
uv tool upgrade maplestats-mcp # update
開発版の場合:uv tool install git+https://github.com/dsanchezp18/maplestats-mcp.git。
コマンドをインストールした場合は、上記の JSON で args を指定せず、
"command": "maplestats-mcp" を使用してください。Windows では、uv が
ツールをインストールするディレクトリが PATH に含まれていることを確認し、
その後クライアントを再起動してください。
使い方
ツールは一覧から選ぶのではなく、検索して見つけます。平易な言葉で(英語またはフランス語)
search_tools を呼び出し、続けて返された名前で
call_tool を呼び出してください。
{"name": "search_tools", "arguments": {"query": "consumer price index"}}
{"name": "call_tool", "arguments": {"name": "wds_search_cubes", "arguments": {"query": "consumer price index"}}}
plan_query は質問を複数のソースにまたがる順序付きプランに変換し、
reproduce_code は同じデータをソースから直接取得する R、Python、Stata、Julia のスクリプト
(または Excel Power Query)を作成します。reproduce_workbook は書式設定済みの Excel
ワークブックとして行を返します。すべてのツールで lang: "en"|"fr" を指定できます。
一部のソースは英語のコンテンツのみを公開しているため(例:Yukon の CKAN ポータル、
World Bank の指標定義、PMPRB)、その場合、lang によって変更されるのは MapleStats が追加する
ラベルであり、ソース自体のテキストは変わりません。すべての応答には、
ソース、URL、クエリの時刻、鮮度、制限事項を示す provenance ブロックが含まれます。
docs://catalogue には、各モジュールの説明が両言語で記載されています。ガイド付き
プロンプトでも lang を指定でき、各 docs://<module>/... リソースにはフランス語版の
docs://<module>/fr/... が用意されています(例:docs://statcan/fr/pieges)。
注意事項
MapleStats は元のソースから直接データを取得し、公開されている値を返します。結果が
切り詰め、スケーリング、クリーニング、または計算されている場合は、
provenance ブロックまたは注記にその旨が記載されます。系列の値はスケーリングされずに返され、
スケール係数がその横に示されます。ソースが停止している場合やリクエストをブロックした場合、
ツールはエラーを返し、空白や代替値で済ませることはありません。
リスクは使い方にあります。AI アシスタントが誤った表、地域、または参照期間を選ぶことがあり、
生成する回答、要約、分析には誤りが含まれる可能性があります。公開するものについては、
いくつかの数値をソースのサイトで照合し、reproduce_code を使って
アシスタントの外部でもう一度取得してください。公開元は数値を改訂するため、
今日取得した値は以前の値と異なる場合があります。
各データセットには独自のライセンスと帰属表示の条件があり、結果の
provenance に示されています。クレジットは MapleStats ではなく、公開元に付与してください。
MapleStats は独立したプロジェクトであり、Statistics Canada、Bank of Canada、CMHC、
その他のデータプロバイダーとは提携しておらず、承認も受けていません。本ソフトウェアは
現状有姿で提供され、変更や停止の可能性がある上流サービスに依存しており、専門的、法律的、
または財務的な助言を提供するものではありません。コードとテストの一部は AI の支援を受けて
作成されています。検出ベンチマークの質問は、ある AI セッションで作成され、別の独立した
セッションでレビューされましたが、まだ人間によるレビューは受けていません
(tests/discovery_benchmark/REVIEW.md)。
対応範囲
75 モジュールで 380 ツールに対応しています。全項目を掲載したバイリンガル一覧は
docs://catalogue を実行して確認してください。
| 分野 | ツールのプレフィックス | 対象 |
|---|---|---|
| カナダ統計局 | wds_、sdmx_、sdmx_space_、rdaas_、cimt_、statcan_* | 表と時系列データ、追加の SDMX スペース(エネルギー情報、共有データ)、分類、2001~2021 年の国勢調査プロファイル、公開用ミクロデータ(コードブック、加重集計表)、品目別商品貿易(CIMT)、オープンデータベース(LODE)、The Daily、差分ファイル、指標、調査、国勢調査の地理情報 |
| カナダ銀行 | boc_ | Valet の時系列データ、グループ、観測値 |
| CMHC | cmhc_、cmhc_dt_ | 住宅市場情報ポータルと Excel データテーブル |
| 連邦政府機関 | eccc_、eccc_coverages_、eccc_datamart_、ised_*、gazette_、tc_recalls_、recalls_、cdc_、cfia_、fcac_、finance_、cihi_、phac_infobase_、hc_*、pmra_、pmprb_、gc_infobase_、cer_、nrcan_*、dfo_iwls_、cgc_、nfd_、ircc_*、cbsa_、cbsa_tariff_、pbo_、competition_bureau_、elections_results_、elections_financial_returns_、cra_digital_economy_registry_、earthquakes_、borealis_、isc_ | 気象、気候および格子状の気候予測、汚染物質の排出(NPRI、GHGRP、NAPS)、企業と知的財産、規制、リコール、乳製品、動物疾病、消費者向け銀行サービス、連邦および州の財政表、医療、医薬品、天然健康製品、医療機器、副作用、農薬、支出、エネルギー、鉱物生産、海洋、穀物、林業、移民、国境での待ち時間、関税率、予算、企業合併、選挙、地震、大学図書館のデータテーブル、先住民ファースト・ネーションのプロファイル、登録人口、飲料水に関する勧告 |
| 森林火災 | cwfis_、nrcan_nbac_、ab_wildfire_ | NRCan のカナダ森林火災情報システム(衛星によるホットスポット、火災危険度、気象観測所)、焼失区域、Alberta Wildfire のリアルタイム火災状況 |
| 電力 | electricity_ontario_、electricity_quebec_、oeb_ | IESO(オンタリオ州)の需要、発電量、価格、Hydro-Québec の需要、発電量、電力取引(CC BY-NC 4.0:Hydro-Québec をクレジット表記し、非営利目的でのみ使用可)、Ontario Energy Board のデータセット |
| 議会と公選職 | ourcommons_、senate_、represent_ | 国会議員とその役職、政党の勢力、内閣、上院の投票、Open North の Represent を通じた郵便番号に基づく公選職者と選挙区(非公式) |
| 州政府機関 | aer_、bcgw_、bc_stats_、bc_env_、bc_lobbyists_、drivebc_、ab_economic_、ab_opendata_、isq_、nl_stats_、yukon_stats_、nwt_stats_、elections_provincial_、on_fir_ | Alberta Energy Regulator、BC Geographic Warehouse、BC Stats の Excel テーブル、BC の環境モニタリング(大気質、積雪、地下水、河川流量)、BC のロビイスト登録簿、DriveBC の道路イベント、Alberta Economic Dashboard、Open Alberta のファイル、Institut de la statistique du Québec、ニューファンドランド・ラブラドール州、ユーコン準州、ノースウェスト準州の統計局、州議会の総選挙結果(ケベック州、アルバータ州、ブリティッシュコロンビア州、サスカチュワン州、マニトバ州)、オンタリオ州の自治体財務情報報告書(2000 年以降の全自治体の全様式) |
| 住宅(リンクのみ) | crea_ | CREA の MLS® Home Price Index へのリンク、公開時期、利用条件。CREA の利用条件では非公開の非営利分析のみが認められているため、数値は含まれません |
| 国際機関 | worldbank_、bis_ | カナダと同等国を対象とする世界銀行の World Development Indicators(CC BY 4.0)、国際決済銀行の統計:政策金利、債務返済比率、信用、住宅価格、銀行および決済に関する統計(出典を明記すれば自由に再利用可能) |
| オープンデータポータル | ckan_、arcgis_hub_、socrata_ + portal | 連邦、州、準州、自治体のカタログ(各カタログは *_list_portals の名前で識別できます) |
| その他の自治体 | opendatasoft_vancouver_、nl_opendata_、eps_、ets_、epcor_ | バンクーバー、ニューファンドランド・ラブラドール州、エドモントンの警察、交通機関、水質 |
| 公共交通機関の時刻表 | transit_ + agency | STM(バス)、OC Transpo、Calgary Transit、VIA Rail、GO Transit、UP Express、BC Transit の各システム、Données Québec に掲載されているケベック州のネットワーク(exo、RTC、STL、STS など)、さらにカナダ統計局の 2025 Canadian Public Transit Network Database に収録された各機関の静的 GTFS 時刻表:停留所、路線、予定出発時刻、時間帯別の運行頻度 |
| その他の連邦政府の統計シリーズ(CRA、OSFI、ISED の倒産関連データ)は通常の | ||
| open.canada.ca データセットです。 | ||
ckan_search_datasets(portal="federal", fq="organization:<org>") からアクセスできます。 |
対象外:CAPP の Statistics Handbook、Petrinex、Payments Canada は、利用規約またはダウンロード先のホストが自動アクセスを許可していないため、実装していません。CanadaBuys、OpenParliament.ca、トロント交通局独自の時刻表ダウンロードも同じ理由で削除しました(TTC の時刻表は現在も Statistics Canada の全国公共交通データベースから提供されています)。サスカチュワン州の GeoHub ポータルも削除しました。2006~2016 年の国勢調査データ表と 2016 Census Profile サービスは、Statistics Canada の www12 ホストが自動クライアントにボット対策チャレンジ、503 エラー、またはタイムアウトを返すため、削除しました(2021 年版 Profile と WDS の表は引き続き利用できます)。Justice Laws(連邦法令)は、法令のテキストがこのサーバーの扱うデータではないため対象外です。また、サスカチュワン州統計局の Provincial Economic Accounts は実装していません。これらは国王著作権の対象で、非営利目的での再利用に限られており、サイトの利用規約で自動アクセスが禁止されています。 ロードマップ に各判断を記録しています。
開発
uv sync # install
uv run ruff check src tests # lint
uv run ruff format src tests # format
uv run pyright # type check
uv run pytest # unit tests (mocked, no network)
.\scripts\verify.ps1 はこのチェックに加え、稼働中の API に対して scripts/smoke_test*.py
をすべて実行します。ウェブサイトはツールレジストリから生成されます。
uv run python scripts/build_site.py を実行すると build/site/ に書き出されます。
コントリビューター向けガイドとソースモジュールの追加方法については、
AGENTS.md
を参照してください。
ホスティング
MAPLE_TRANSPORT=http MAPLE_HOST=0.0.0.0 MAPLE_PORT=8000 uv run maplestats-mcp
を実行すると、stdio の代わりに HTTP で提供します。Docker では docker compose up --build を実行すると同様に動作します。Docker は任意であり、個人のコンピューターでは不要です。サーバーを自分のマシンの外部に公開する場合は、MAPLE_AUTH_TOKEN を設定し、MAPLE_REQUIRE_AUTH=1 を維持してください。GET /health は稼働時間とバージョンを報告します。GET /stats
は公開エンドポイントで、トークンは不要です。ツール名および日ごとの呼び出し回数、各ツールの p50 と p95 の実行時間、各上流ホストのエラー数とサーキットブレーカーの状態を報告します(以下の MAPLE_USAGE_STATS と MAPLE_BREAKER を参照)。タイムアウト、接続エラー、5xx 応答、Cloudflare のチャレンジなどの障害が繰り返し発生すると、ホストはクールダウンのため一時停止します。そのホストのツールはすぐに「unavailable」エラーを返し、再試行のタイミングを知らせるため、次のタイムアウトまで待つ必要はありません。docs://status リソースには一時停止中のホストが一覧表示されます。
公開エンドポイントは Render の無料プランで稼働しています。メモリは約 512 MB、リクエストが 15 分間ないとスリープし、ワークスペース全体で月 750 時間までインスタンスを利用できます。同じワークスペース内のすべての無料サービスでこの時間を共有します。2026-10-24 時点で、ワークスペースはこのうち 659 時間を使用していました。10 月 19 日から 24 日までの Render のログによると、maplestats-mcp は稼働時間の 91%動作していました。数分おきに接続する実際の MCP クライアントによって起動状態が維持されており、監視用の ping によるものではありませんでした。また、同じワークスペース内の別の無料サービスも、長時間にわたって約 15 分おきに起動していました。このペースでは月末前に利用時間が尽き、ワークスペース内のすべての無料サービスが 1 日まで停止します。2026-10-24 以降、チャットデモ(chat/render.yaml)とその別サービスはそれぞれ独自のワークスペースで稼働しているため、このサーバーは 750 時間を単独で利用できます。
| 環境変数 | デフォルト | 用途 |
|---|---|---|
MAPLE_TRANSPORT | stdio | ローカルクライアントには stdio、ホスティングには http を使用します |
MAPLE_HOST / MAPLE_PORT | 127.0.0.1 / 8000 | HTTP バインドアドレス |
MAPLE_AUTH_TOKEN, MAPLE_REQUIRE_AUTH | 未設定、0 | /mcp で必要なベアラートークンです。1 の場合、トークンなしでは起動を拒否します。docker-compose.yml では MAPLE_REQUIRE_AUTH のデフォルトが 1 です |
MAPLE_RATE_LIMIT_REQUESTS / MAPLE_RATE_LIMIT_WINDOW_SECONDS | 120 / 60 | クライアントごとのレート制限 |
MAPLE_MAX_CONCURRENT_REQUESTS | 8 | 同時処理中のリクエスト上限です。超過分は 5 秒間待機し、その後 503 が返されます |
MAPLE_SSL_CERTFILE / MAPLE_SSL_KEYFILE | 未設定 | プロセス内の TLS |
MAPLE_TRUST_PROXY_HEADERS | 0 | X-Forwarded-For に基づいてレート制限します。このヘッダーを設定するプロキシの背後でのみ使用してください |
MAPLE_TRUSTED_PROXY_HOPS | 1 | X-Forwarded-For に値を追加するプロキシの数です。クライアントアドレスは右から数えてその数だけ進んだ項目から読み取ります |
MAPLE_ALLOWED_ORIGINS | プロジェクトのウェブサイト、localhost | /mcp で許可するブラウザーのオリジンです(カンマ区切り、*. と :* のワイルドカードに対応)。それ以外には 403 が返されます。Origin のないクライアントは許可されます |
MAPLE_CACHE_MAX_ENTRIES | 2000 | TTL バケットごとのレスポンスキャッシュサイズ |
MAPLE_CACHE_MAX_MB | 128 | 全バケット合計でのレスポンスキャッシュの推定メモリ上限 |
MAPLE_PARSE_WORKERS / MAPLE_PARSE_TIMEOUT_SECONDS | 4 / 60 | Excel ファイルと CSV ファイルの解析に使用するスレッド数、および 1 回の解析に許可する時間 |
MAPLE_TOOL_TIMEOUT_SECONDS | 120 | ツール呼び出しの最長実行時間 |
MAPLE_BREAKER | 1 | 繰り返し失敗した場合にアップストリームホストへのリクエストを一時停止します。0 の場合はすべてのリクエストを送信します |
MAPLE_BREAKER_FAILURES / MAPLE_BREAKER_WINDOW_SECONDS / MAPLE_BREAKER_COOLDOWN_SECONDS | 5 / 300 / 60 | ホストへのリクエストを一時停止する、ウィンドウ内の連続失敗回数と、プローブリクエストを 1 件送信するまでの待機時間 |
MAPLE_PUMF_TABULATE | 1 | 0 にすると statcan_pumf_tabulate が非表示になります(PUMF の ZIP 全体をダウンロードするため)。検索、一覧表示、コードブックは引き続き利用できます |
MAPLE_PUMF_CACHE_DIR, MAPLE_PUMF_CACHE_MAX_GB | システムの一時ディレクトリ、5 | ダウンロードしたマイクロデータのキャッシュです。ホスティング時は永続ボリュームを使用してください |
MAPLE_CLIENT_IP_HEADER | 未設定 | 最前段のプロキシが呼び出し元自身のアドレスを設定するヘッダー(Cloudflare の CF-Connecting-IP)です。MAPLE_TRUST_PROXY_HEADERS が有効な場合、クライアントごとのレート制限に使用されます。すべてのリクエストがそのプロキシを経由する場合にのみ設定してください |
MAPLE_DUCKDB_MEMORY_LIMIT | 未設定 | ダウンロードしたファイル(特許、オープンデータベース、マイクロデータ)に対する DuckDB クエリのメモリ上限です。例:256MB。上限を超えると、DuckDB は一時フォルダーにデータを書き出します。小規模なホスティング環境で設定してください |
MAPLE_LODE_CACHE_DIR, MAPLE_LODE_CACHE_MAX_GB | システムの一時ディレクトリ、3 | StatCan オープンデータベース(LODE)のアーカイブを展開する場所とサイズ上限です(最終アクセスが最も古いファイルから削除されます)。ホスティング時は永続ボリュームを使用してください |
MAPLE_LODE_MAX_DOWNLOAD_MB | 300 | 1 回の呼び出しでダウンロードできるオープンデータベースアーカイブの最大サイズです。0 にするとダウンロードが無効になります |
MAPLE_IP_HORIZONS_CACHE_DIR, MAPLE_IP_HORIZONS_CACHE_MAX_GB | システムの一時ディレクトリ、3 | CIPO 特許テーブルのキャッシュ |
MAPLE_CBSA_TARIFF_CACHE_DIR | システムの一時ディレクトリ | Parquet 形式の関税率表の版(各 1 MB 未満で、新しいものから 12 件を保持) |
MAPLE_ON_FIR_CACHE_DIR, MAPLE_ON_FIR_CACHE_MAX_MB | システムの一時ディレクトリ、500 | Parquet 形式で保持するオンタリオ州の FIR 年度データ(各約 3 MB)です。ホスティング時は永続ボリュームを使用してください |
MAPLE_EXPORT_DIR | Downloads フォルダー(存在しない場合はホームフォルダー) | ローカルサーバー上で reproduce_workbook が Excel ワークブックを保存する場所 |
MAPLE_SEARCH, MAPLE_SEMANTIC_DIR | bm25、未設定 | hybrid は BM25 とローカルの multilingual-e5-small インデックスを統合します([semantic] エクストラと python -m maplestats_mcp.shared.semantic build が必要)。デフォルトでは無効です。tests/discovery_benchmark/phase2.md を参照してください |
MAPLE_RESPONSE_MAX_BYTES | 200000 | 1 件のツール結果のバイト数上限です(最小 10,000)。上限を超える結果では、サイズの大きいリストが切り詰められます。保持された内容と残りの取得方法は provenance.limits に示されます |
MAPLE_USAGE_STATS | 1 | ツール名と UTC 日ごとの呼び出し回数および所要時間、ホストごとのアップストリームエラーをメモリ上で集計し、公開 /stats ルートで提供します(引数やクライアントアドレスは記録しません)。0 にすると、どちらも無効になります |
MAPLE_DELTA_MAX_SCAN_MB / MAPLE_DELTA_MAX_SCAN_SECONDS | 400 / 75 | 1 回の statcan_delta_read_table 呼び出しでストリーミングする Delta ファイルの量です(秒数はツールのタイムアウトより 30 秒短く設定されます) |
MAPLE_DELTA_INDEX_DIR | システムの一時ディレクトリ | 保存済みの Delta ファイル再開位置(1 日あたり数 MB)です。off にするとメモリ内のみに保持します |
ライセンス
MIT。サードパーティに関する通知はTHIRD_PARTY_NOTICES.mdにあります。
セキュリティと行動規範
脆弱性は、GitHub の
非公開の脆弱性報告から非公開で報告してください。
詳細はSECURITY.mdをご覧ください。変更は
CHANGELOG.mdに記録され、コミュニティでの行動規範は
CODE_OF_CONDUCT.mdに記載されています。
謝辞
MapleStats のアーキテクチャは、 DweskZやほかの貢献者とともに私が保守に携わっている、エクアドルのオープンデータ向け MCP サーバー EcuDataMCPから着想を得ています。カナダのデータへのアプローチは、先駆けて取り組んだ R の開発者たちに大きく負っています。Jens von Bergmann (mountainMath)と、Dmitry Shkolnik (dshkol)、Thierry Warin (statcanR)、Valentin Lucet (rgovcan)を含む共著者の皆さん、そしてほかの方々です。皆さんに、そしてカナダのデータをオープンに公開しているすべての方々に感謝します。
カナダのデータを入手するほかの方法については、 代替手段をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。