demo-mcp-server

demo-mcp-server

0
developer_tools

This project is a TypeScript-based MCP server designed to demonstrate core concepts of the Model Context Protocol through a project management system. It features tools for creating and accessing projects programmatically.

demo-mcp-server MCP Server

A Model Context Protocol server

A TypeScript-based MCP server demonstrating core concepts through a ​project management system. Key components:

​Resources: Query projects via URIs and hierarchical paths ​Tools: Create and open projects programmatically

goal: Tell AI to open the project, and AI will call MCP Server to open the project and run it locally

Features

Resources

  • List and access projects via project:// URIs
  • Each project has a project name, path and metadata
  • Plain text mime type for simple content access Alt text

Tools

  • create_project - Create new text projects
    • Takes title and content as required parameters
    • Stores project in server state
  • open_project - open project

Alt text Alt text

Development

  • Install dependencies:
npm install
  • Build the server:
npm run build
  • For development with auto-rebuild:
npm run watch
  • Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npx @modelcontextprotocol/inspector node .../demo-mcp-server/build/index.js

The Inspector will provide a URL to access debugging tools in your browser.

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
    "demo-mcp-service": {
      "command": "/usr/local/bin/node",
      "args": [
        ".../demo-mcp-server/build/index.js"
      ],
      "disabled": false,
      "autoApprove": []
    }
}