MCP.so
Sign In

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

@sunmer

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

Simple MCP server using Claude to interact with a local JSON server

Basic information

Category

AI & Agents

Runtime

node

Transports

stdio

Publisher

sunmer

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More AI & Agents MCP servers