🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server

What is 🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server?

A basic setup guide that demonstrates how to use Claude (MacOS desktop) to interact with a local mock JSON server via the Model-Computer Protocol (MCP). It is intended for developers learning how to integrate MCP tools with a local API.

How to use 🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server?

Install dependencies with npm install, then run npm run mock-api and npm run mcp-server. Edit the claude_desktop_config.json file to add the MCP server configuration, restart Claude, and prompt it with commands like "get all posts" or "insert a post with id 500, title 'created by claude' and views 123".

Key features of 🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server

• Uses MCP to connect Claude to a local JSON server
• Two MCP tools appear after configuration
• Supports CRUD‑style prompts (get, insert)
• Works with Claude for MacOS desktop
• Requires Node.js and npm dependencies
• Includes a testing inspector command

Use cases of 🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server

• Retrieve all posts from a local mock JSON server via Claude
• Insert a new post with custom fields using natural language prompts
• Test MCP tool functionality with the official inspector
• Learn how to configure MCP servers in Claude Desktop

FAQ from 🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server

What are the prerequisites?

Node.js installed, Claude for MacOS (download from Anthropic), and basic understanding of local servers and MCP tools.

How do I install and run the dependencies?

Run npm install in the project root, then npm run mock-api to start the JSON server and npm run mcp-server to start the MCP server.

How do I configure Claude to use the MCP server?

Edit the claude_desktop_config.json file (usually in ~/.claude/ or the app’s internal config folder) and add the MCP server configuration with the command node and the absolute path to dist/index.js.

What tools appear in Claude after configuration?

Two new MCP tools marked with a 🛠️ hammer icon appear below the input bar.

How can I test the MCP server?

Run npx @modelcontextprotocol/inspector node build/index.js and view the available resources at http://127.0.0.1:6274/#resources.