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

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

Local
github.com/sunmerAI & Agents0Updated 82w ago
Repository

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

A small MCP server example that lets Claude for macOS use a local mock JSON server. It demonstrates wiring MCP tools to requests for reading and inserting posts.

Key features

  1. 01Connects Claude to a local JSON server
  2. 02Supports retrieving posts
  3. 03Supports inserting posts
  4. 04Includes MCP Inspector test instructions

Use cases

  1. 01Try MCP tools with a local mock API
  2. 02Test post retrieval and insertion through Claude

MCP support

Exposes tools that let an MCP client send requests to the local mock JSON server.

#mcp#json-server#claude

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

This guide walks you through a basic setup where you use Claude (MacOS desktop) to interact with a local mock JSON server via MCP (Model-Computer Protocol).

🧰 Prerequisites

  • Node.js installed
  • Claude for MacOS (download from Anthropic)
  • Basic understanding of how local servers and Claude MCP tools work

🚀 Step-by-Step Setup

1. Install Dependencies

In the root of your project, install the required packages:

npm install
npm run mock-api
npm run mcp-server

Edit the claude_desktop_config.json file (usually found in ~/.claude/ or the app's internal config folder), and add your MCP server config:

{
  "mcpServers": {
    "json-chat": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-example/dist/index.js"]
    }
  }
}

  • Restart Claude

  • Once restarted, you should see two new MCP tools appear below the input bar in Claude, each marked with a 🛠️ hammer icon:

  • Try prompting Claude with something like:

"get all posts"

"insert a post with id 500, title "created by claude" and views 123"

Claude will use the MCP tools you've configured to send actual requests to your local mock server.

Make sure you're running the JSON server, MCP server when you prompt Claude.

Testing

Run

npx @modelcontextprotocol/inspector node build/index.js

You should then see all of the available resources at http://127.0.0.1:6274/#resources

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.