furunavi-mcp-community
furunavi-mcp-community
ふるさと納税サイト「ふるなび」を扱う非公式のMCPサーバーです。MVPとして、返礼品検索、詳細取得、ブラウザログイン、お気に入り追加を提供します。
ふるなび運営会社とは無関係です。個人利用を前提とし、サイトの利用規約・robots・アクセス制限を尊重してください。寄附申込みや決済は実装していません。
MCP tools
Tool | 用途 | ログイン |
| キーワード検索 | 不要 |
| 返礼品IDによる詳細取得 | 不要 |
| セッション保存状況 | 不要 |
| ブラウザで対話ログイン | 操作が必要 |
| 保存セッション削除 | 不要 |
| お気に入り追加(冪等) | 必要 |
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 buildClaude 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-runNode.js 20以上を使用します。HTML構造変更により解析処理が壊れる可能性があるため、公開前には実サイトsmoke testを実行してください。
Available Tools
6 toolsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
6 tool updates
v0.1.2- First observed
furunavi_add_favorite - First observed
furunavi_auth_clear - First observed
furunavi_auth_login - First observed
furunavi_auth_status - First observed
furunavi_get_product - First observed
furunavi_search_products
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: authentication management (status, login, clear), product search, product detail retrieval, and adding favorites. No overlapping functionality.
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.
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.
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
Related MCP Connectors
Official remote MCP server for SUZURI.
Public MCP server for discovering open jobs. Search, filter, and get application links.
MCP server for searching Airweave collections with natural language queries.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn unofficial MCP server that integrates with the hokan Insurance CRM API v2 to manage customer data, schedules, and tasks. It also features specialized tools for Japanese insurance law compliance, including intent confirmation and regulatory check generation.-
- AlicenseAqualityDmaintenanceMCP server for Open Food Facts, enabling food product lookup by barcode, search, nutrition facts, allergen checks, and eco-scores without an API key.8MIT
- AlicenseAqualityDmaintenanceUnofficial MCP server for accessing and managing TimeTree calendar data, supporting events, memos, and comments via email/password authentication.69 npmMIT
- FlicenseNot gradedqualityDmaintenanceMCP server for VkusVill grocery store, enabling product search, details retrieval, and cart link creation.3-