Skip to main content
Glama
furunavi-mcp-community

furunavi-mcp-community

by new-village

furunavi-mcp-community

ふるさと納税サイト「ふるなび」を扱う非公式のMCPサーバーです。MVPとして、返礼品検索、詳細取得、ブラウザログイン、お気に入り追加を提供します。

ふるなび運営会社とは無関係です。個人利用を前提とし、サイトの利用規約・robots・アクセス制限を尊重してください。寄附申込みや決済は実装していません。

MCP tools

Tool

用途

ログイン

furunavi_search_products

キーワード検索

不要

furunavi_get_product

返礼品IDによる詳細取得

不要

furunavi_auth_status

セッション保存状況

不要

furunavi_auth_login

ブラウザで対話ログイン

操作が必要

furunavi_auth_clear

保存セッション削除

不要

furunavi_add_favorite

お気に入り追加(冪等)

必要

Related MCP server: openfoodfacts-mcp-server

Setup

npm公開版を利用する場合:

npm install -g furunavi-mcp-community
npx playwright install chromium

ソースから開発する場合:

git clone https://github.com/new-village/furunavi-mcp-community.git
cd furunavi-mcp-community
npm install
npx playwright install chromium
npm run build

Claude Desktop / Claude Code等の設定例:

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

Login

パスワードをMCPへ渡さず、利用者がふるなびの画面で直接ログインします。

node dist/index.js auth
node dist/index.js auth --status
node dist/index.js auth --clear

保存先は ~/.config/furunavi-mcp-community/storage-state.json(mode 0600)です。FURUNAVI_MCP_CONFIG_DIR で変更できます。

リモート・コンテナ環境

headedブラウザを表示できる端末でログインしてください。Remote SSHやヘッドレスサーバーではブラウザ画面を操作できないため、同一ユーザーの設定ディレクトリを安全に移送・マウントする必要があります。storage-stateには認証Cookieが含まれるため、Gitへ追加したり共有したりしないでください。

Development

npm test
npm run typecheck
npm run build
npm run lint
npm audit --omit=dev
npm pack --dry-run

Node.js 20以上を使用します。HTML構造変更により解析処理が壊れる可能性があるため、公開前には実サイトsmoke testを実行してください。

Available Tools

6 tools
furunavi_add_favoriteA

ログイン済みセッションを使い、指定返礼品をお気に入りに追加します。

Inputs: productId (required).

furunavi_auth_clearA

保存済みのふるなびログインセッションを削除します。

Inputs: no named parameters.

furunavi_auth_loginA

ブラウザを開き、利用者自身の操作でふるなびへログインしてセッションを安全に保存します。

Inputs: headless, timeoutSeconds.

furunavi_auth_statusA

ふるなびのログインセッション保存状況を確認します。

Inputs: no named parameters.

furunavi_get_productC

返礼品IDから詳細情報を取得します。

Inputs: productId (required).

furunavi_search_productsC

キーワードでふるなびの返礼品を検索します。

Inputs: keyword (required), page, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: authentication management (status, login, clear), product search, product detail retrieval, and adding favorites. No overlapping functionality.

    Naming Consistency4/5

    All tools share the 'furunavi_' prefix and use snake_case. However, the structure varies: some combine domain and action (e.g., furunavi_auth_login) while others use verb-noun (e.g., furunavi_search_products), creating minor inconsistency.

    Tool Count5/5

    With 6 tools covering authentication, search, product details, and favorites, the count is well-scoped for the domain. Each tool serves a necessary function without bloat.

    Completeness4/5

    Core operations are present (auth CRUD, search, get product, add favorite). Missing features like removing favorites or listing favorites are minor gaps that agents can work around.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers