Reinfolib MCP Server

房地产信息MCP服务器

这个项目是国土交通省的房地产信息库的API用于获取房地产信息Model Context Protocol（MCP）服务器。

📋 前提条件

在开始此项目之前，请确保已安装：

• Node.js （版本18.0.0或更高）
• pnpm （建议）或npm
• Reinfolib API 按键 （从国土交通省取得）
• GIS数据 (N02-22_Station.shp/dbf 文件，手动gis/文件夹需要放置）

🚀 快速启动

1.克隆或下载项目

# GitHubからクローンする場合
git clone https://github.com/fukunaman/reinfolib-mcp-server.git
cd reinfolib-mcp-server

# またはZIPファイルをダウンロードして展開

2.安装依赖关系

# pnpmを使用（推奨）
pnpm install

# または npm を使用
npm install

3.设置环境变量

在项目根目录中 .env 请创建文件并填写以下内容：

REINFOLIB_API_KEY=your_api_key_here

重要: your_api_key_here 实际的Reinfolib API来修改标记元素的显示属性。

4. GIS数据文件放置

要使用车站信息检索功能，需要下载国土数值信息（铁路数据）进行配置。

1. 国土数值信息（铁路数据）访问
2. 下载“令和4年度”数据的“全国”版（N02-22_Station.zip）
3. ZIP解压缩文件，将以下文件 gis/ 复制到文件夹：

- N02-22_Station.shp - N02-22_Station.dbf

# gisフォルダを作成
mkdir gis

# ダウンロードしたファイルをコピー
cp path/to/downloaded/N02-22_Station.* gis/

注意：这些GIS文件容量大Git存储库中没有。请各自下载并配置。

5.构建项目

pnpm run build

6.启动服务器

# 本番環境での起動
pnpm run start

# または開発環境での起動（自動リロード有効）
pnpm run dev

🔧 可用命令

｜命令｜说明｜ |---------|------| | pnpm install 安装依赖关系 | pnpm run build | TypeScript打开JavaScript编译为 | pnpm run start 启动已构建的服务器 | pnpm run dev 在开发模式下启动服务器 | pnpm run clean 删除构建文件

📖 使用方法

MCP客户端连接

该服务器使用标准输入输出（stdio）MCP与客户端通信。Claude Desktop屋脊Cursor等的MCP可以从客户端连接。

Claude Desktop中的设置

Claude Desktop要在中使用此服务器，请创建配置文件：

# 設定ファイルを作成・編集
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

配置文件内容：

{
  "mcpServers": {
    "reinfolib-mcp-server": {
      "command": "node",
      "args": ["path/to/your/reinfolib-mcp-server/dist/server.js"]
    }
  }
}

注意:

• path/to/your/reinfolib-mcp-server 更改为实际项目路径

设定完成后Claude Desktop中所述修改相应参数的值。

可用工具

1.不动产取引情报の検索（search_transactions)

{
  "year": "2023",
  "quarter": "1",
  "area": "13",
  "city": "13101"
}

2.获取市区町村一览表（get_municipalities)

{
  "prefectureCode": "13"
}

3.检索地价公示信息（search_appraisals)

{
  "year": "2023",
  "area": "13",
  "division": "00"
}

4.检索地价公示点信息（search_land_price_points)

{
  "z": 13,
  "x": 7312,
  "y": 3008,
  "year": "2020"
}

5.房地产价格点信息的检索（search_real_estate_price_points)

{
  "z": 13,
  "x": 7312,
  "y": 3008,
  "from": "20223",
  "to": "20234"
}

6.属性搜索（search_properties)

{
  "prefecture": "13",
  "year": "2023"
}

7.获取车站代码（get_station_code)

从车站名取得车站代码。房地产交易查询 station 可用于参数。

{
  "stationName": "新宿"
}

8.駅情报取得（get_station_info)

从车站代码中获取车站信息（名称、坐标等）。

{
  "stationCode": "003700"
}

9. 駅検索 (search_stations)

用车站名和车站代码搜索车站。

{
  "query": "東京"
}

📁 项目结构

reinfolib-mcp-server/
├── src/
│   ├── server.ts          # メインサーバー実装
│   ├── types.ts           # TypeScript型定義
│   ├── config.ts          # 設定ファイル（都道府県コード等）
│   ├── api/
│   │   └── reinfolib.ts   # Reinfolib API ラッパー
│   └── utils/
│       └── station.ts     # 駅情報関連ユーティリティ
├── gis/
│   ├── N02-22_Station.shp # 駅情報Shapefileデータ
│   └── N02-22_Station.dbf # 駅情報データベース
├── dist/                  # ビルド出力ディレクトリ
├── package.json
├── tsconfig.json
├── .env                   # 環境変数（手動作成）
├── .gitignore             # Git除外設定
├── CLAUDE.md              # Claude Code用ガイダンス
└── README.md

🗾 GIS关于数据

车站信息查询功能使用国土交通省国土数值信息（铁路数据）：

• 数据源: 国土交通省 国土数値情報（鉄道）N02-22
• 数据格式：ESRI形状文件
• 收録駅数: 10,220駅
• 字符编码：转换JIS

车站代码格式

车站代码由6位数构成（例如：新宿站=003700，东京站=003766）。

🔑 API获取密钥的方法

1. 国土交通省房地产信息库访问
2. 创建帐户
3. API申请、取得密钥
4. 已获取API按键 .env 设置为文件

🎯 使用例

从车站名检索房地产交易

// 1. 駅名から駅コードを取得
const stationCode = await getStationCode("新宿");
// 結果: "003700"

// 2. 駅コードを使って不動産取引を検索
const transactions = await searchTransactions({
  year: "2023",
  quarter: "1",
  area: "13",
  station: stationCode
});

🤝 分发

错误报告、功能建议、Pull Request等，欢迎发布！

Issue 屋脊Pull Request 请随意制作。