Skip to content

jaywalker21/mcp-tutorial-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Note

This is powered by the documentation generated and shared by Chirag, all credits go to him

MCP Server Configuration Setup

This directory contains pre-configured JSON files for easy setup of all MCP transport modes.

📊 Architecture Overview

For a detailed understanding of how each MCP server implementation works, including visual diagrams and architecture explanations, see the Architecture Documentation.

The diagrams show:

  • STDIO (Standard I/O) communication pattern
  • MCP protocol request/response sequences
  • Component interactions and data flow

Quick Setup

For Claude Desktop

  1. Copy the configuration:

    cp guides/claude_mcp.json ~/Library/Application\ Support/Claude/claude_desktop_config.json
  2. Update the stdio path in the copied file to match your actual installation path

  3. Restart Claude Desktop

For Cursor IDE

  1. Copy the configuration:

    cp guides/cursor_mcp.json ~/.cursor/mcp_servers.json
  2. Update the stdio path in the copied file to match your actual installation path

  3. Restart Cursor

Before Using

1. Install dependencies

npm i
npm i -g tsx

2. Test with debugger once

npx @modelcontextprotocol/inspector tsx src/index.ts

Available Servers

All three servers provide identical functionality:

  • Tools: calculator, system_info
  • Prompts: math_tutor, code_review
  • Resources: system://status, math://constants

Transport Methods

  1. tutorial-mcp-stdio - Standard input/output (always available)

Testing

After setup, test with any of these commands in Claude/Cursor:

  • "Calculate 25 * 4 using the calculator tool"
  • "Show me system information"
  • "Use the math tutor prompt for algebra"

Troubleshooting

  • Stdio not working: Check that the binary path is absolute and executable
  • Changes not taking effect: Restart the application completely

About

MCP Tutorial for any JS/TS Developer

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published