mcp

This MCP server implements the MCP 2025-06-18 protocol for the OpenFacet Diamond Pricing API. It exposes a local Node.js HTTP server (and can be adapted to run behind a Cloudflare Worker). Core capabilities include the get_diamond_price tool for interpolated diamond pricing across carat, color, and clarity; get_dcx_index for a composite price trend index; and get_market_depth to retrieve inventory depth. Clients communicate via JSON-RPC over HTTP to the root endpoint, with a health check available at /health and discovery metadata at /.well-known/mcp.json. To use locally, start the server and send JSON-RPC requests to the root endpoint; you can also query the discovery file to understand supported methods and protocol version.

Prerequisites:

• Node.js >= 18
• Git

Installation steps:

1. Clone the repository: git clone https://github.com/openfacet/mcp-server.git cd mcp-server

2. Install dependencies (if any): Note: This project is described as zero external dependencies; no npm install is required for this server.

3. Run the server:

   • To run the standard Node.js HTTP server (default port 3000): node node.js
   • Alternatively, to run the standard IO transport (stdio) for local testing: node stdio.js

4. Verify:

   • Access http://localhost:3000/health to check status
   • Send a sample JSON-RPC request to http://localhost:3000/ to exercise tools/call

Optional: If deploying behind a reverse proxy or in Cloudflare Workers, refer to OpenFacet deployment docs and adjust the entrypoints accordingly.

Notes and tips:

• The server implements MCP 2025-06-18 without batch support. Use the provided tools: get_diamond_price, get_dcx_index, and get_market_depth.
• Default port is 3000; override via PORT environment variable when running: PORT=8080 node node.js
• If using Cloudflare Worker, the entrypoint is a single-fetch style adapter as described in the repository.
• The repository is described as single-file deployable with vanilla JavaScript and no external dependencies; this simplifies deployment but do not expect extra npm modules.
• Ensure clients set the MCP-Protocol-Version header to 2025-06-18 for compatibility.
• Discovery metadata is available at /.well-known/mcp.json for client discovery.