🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server
Simple MCP server using Claude to interact with a local JSON server
sunmer
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor
Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.