MCP Server

🚀 OpenFacet MCP Server

OpenFacetのダイヤモンド価格APIに対応したModel Context Protocol (MCP) の実装です。補間アルゴリズムと市場深度分析により、透明でリアルタイムのダイヤモンド価格データを提供します。

バニラJavaScriptとコアモジュールのみで構築されており、外部依存関係は一切ありません。

🚀 クイックスタート

Node.js ≥18が必要です。リポジトリをクローンします。

git clone https://github.com/openfacet/mcp-server.git
cd mcp-server

ローカルstdioトランスポート

stdioトランスポートは、ほとんどのMCPクライアントのデフォルトです。

# サーバーを起動
node stdio.js

メッセージを送信します（このJSONを貼り付けてEnterキーを押します）。

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_diamond_price","arguments":{"carat":1.23,"color":"G","clarity":"VS2"}}}

次のような応答が返されます。

{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"💎 **Diamond Price Quote**\n\n**Specifications:**\n• Carat: 1.23ct\n• Color: G\n• Clarity: VS2\n• Shape: round\n\n**Pricing:**\n• Per Carat: $4,487\n• Total Price: $5,519.01\n\n*Prices from OpenFacet.net API*"}],"_meta":{"timestamp":"2025-07-11T10:21:50.460Z","source":"OpenFacet.net API"}}}

ローカルNode.js HTTPサーバー

デフォルトでは localhost:3000/ にバインドされます。利用可能なエンドポイントは以下の通りです。

• POST /: JSON-RPCエントリーポイント
• GET /health: サーバーのステータス
• GET /.well-known/mcp.json: ディスカバリメタデータ

リモートMCPサーバー

テスト用のリモートサーバーは https://mcp.openfacet.net です。価格クエリの例:

curl -X POST https://mcp.openfacet.net/ \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_diamond_price",
      "arguments": {
        "carat": 1.23,
        "color": "G",
        "clarity": "VS2"
      }
    }
  }'

✨ 主な機能

• MCP 2025‑06‑18を実装（バッチサポート、構造化コンテンツ、バージョンヘッダなし）
• ツール: get_diamond_price, get_dcx_index, get_market_depth
• カラット/色/クラリティに対するリアルタイム補間
• 日次更新のDCXインデックスと在庫スナップショット
• 単一ファイルでのデプロイ可能; 依存関係なし
• ランタイムアダプター:
  • Node.js: HTTPサーバー、CORS、ポート設定可能
  • Cloudflare Worker: 単一のフェッチエントリーポイント

📦 インストール

環境要件

• Node.js ≥18

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/openfacet/mcp-server.git
cd mcp-server

💻 使用例

基本的な使用法

# ローカルstdioトランスポートでサーバーを起動
node stdio.js

# ダイヤモンド価格を取得するリクエストを送信
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_diamond_price","arguments":{"carat":1.23,"color":"G","clarity":"VS2"}}}

高度な使用法

# リモートMCPサーバーを使用してダイヤモンド価格を取得
curl -X POST https://mcp.openfacet.net/ \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_diamond_price",
      "arguments": {
        "carat": 1.23,
        "color": "G",
        "clarity": "VS2"
      }
    }
  }'

📚 ドキュメント

ツール概要

get_diamond_price

丸形/クッション形のGIAダイヤモンドの補間価格を返します。

パラメータ:

• carat: 数値 (0.3–6.0)
• color: 文字列 (D–M)
• clarity: 文字列 (FL–I3)
• shape: 文字列 (オプション、デフォルト: "round")

get_dcx_index

ダイヤモンド価格トレンドの複合インデックスを返します。パラメータはありません。

get_market_depth

在庫データを返します。オプションのパラメータ:

• carat: 数値

テスト

node test-core.js

以下の項目をカバーしています。

• 補間動作
• DCX/市場深度の解析
• エラー条件
• JSON-RPCの正確性

🔧 技術詳細

補間

• 固定ブレークポイント間の対数空間補間
• 心理的閾値（0.3、0.5、1.0など）近くのアンカースムージング
• 価格トレンドがバンドを超えて続く場合の動的ブースト

仕様

• APIドキュメント: https://openfacet.net/en/api-docs/
  • /matrix.json と /matrix_cushion.json: 基本価格マトリックス
  • /index.json: DCXインデックスとトレンド
  • /depth.json: カラット/色/クラリティ別の市場深度
• 価格算出方法: https://openfacet.net/en/methodology/

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は https://opensource.org/licenses/MIT を参照してください。

プロジェクト構造

mcp-server/
├── core.js         # 共有ロジック、ツールハンドラ、補間
├── stdio.js        # ローカルstdioトランスポート
├── node.js         # Node.js HTTPサーバー (PORTはCLIまたは環境変数で指定)
├── worker.js       # リモートCloudflare Worker
├── test-core.js    # バニラJSテストランナー
├── mcp-version.js  # プロトコルバージョン定数
└── README.md