Property Prices MCP

🚀 不動産価格検索 MCP サーバー

このサーバーは Model Context Protocol (MCP) を使用しており、HM 土地登記簿の SPARQL エンドポイントを利用し、英国の郵便番号を使って不動産価格を検索することができます。

🚀 クイックスタート

この不動産価格検索 MCP サーバーを使うことで、英国の不動産価格を郵便番号や住所で簡単に検索できます。

✨ 主な機能

• 郵便番号または通り名と都市名の組み合わせで不動産価格を検索することができます。
• 価格範囲、不動産タイプ、日付範囲で検索結果を絞り込むことができます。
• HM 土地登記簿の公共 SPARQL エンドポイントに接続します。
• MCP stdio 転送を実装し、IDE との統合をサポートします。
• TypeScript で実装されており、完全な型安全性を備えています。
• 包括的なテストスイートが用意されています。
• CLI インターフェイスを提供し、直接使用することができます。

📦 インストール

グローバルインストール

npm install -g property-prices-mcp

ローカルインストール

npm install property-prices-mcp

💻 使用例

基本的な使用法

コマンドラインインターフェイス

property-prices-mcp

ライブラリとしての使用

import { McpClient } from '@modelcontextprotocol/sdk/client';

const client = new McpClient();
const result = await client.resource('property-prices').query({
  postcode: 'SW1A 1AA',
  minPrice: 1000000,
  propertyType: 'flat',
  limit: 5,
});

console.log(result);

📚 ドキュメント

使用上の注意事項

大文字小文字の区別

英国の土地登記簿のデータは、通り名と都市名の大文字小文字を区別します。ただし、この MCP は land registry API に送信する前にこれらのパラメータを自動的に大文字に変換するため、検索時に任意の大文字小文字を使用することができます。

例：

"Cherry Drive" と "CHERRY DRIVE" はどちらも正常に動作します。

検索パラメータ

サーバーは以下の検索パラメータを受け付けます。

応答形式

サーバーは以下の JSON 形式の応答を返します。

{
  "properties": {
    "price": number,
    "bedrooms": number,
    "bathrooms": number,
    "yearBuilt": number,
    "date": string,
    "location": string
  }
}

エラー処理

エラーが発生した場合、サーバーは以下の JSON 形式のエラー応答を返します。

{
  "error": {
    "code": number,
    "message": string
  }
}

可能なエラーコードとメッセージは以下の通りです。

• 400: "無効なリクエストパラメータ"
• 404: "データが見つかりません"
• 500: "サーバー内部エラー"

開発

コントリビューションのガイドラインやプルリクエストの提出プロセスについては、CONTRIBUTING.md をご覧ください。

変更履歴

変更の一覧とバージョン履歴については、CHANGELOG.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。