furunavi-mcp-community

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

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

MCP tools

Related MCP server: tinyfish-search-fetch-mcp

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を実行してください。