mcpField
D
demo-mcp-server MCP Server

demo-mcp-server MCP Server

Local
github.com/xu1211Developer Tools0Updated 82w ago
Repository

About demo-mcp-server MCP Server

A TypeScript MCP server demo for project management, intended for AI clients that need to create or open local projects. It exposes project data as resources and project operations as tools.

Key features

  1. 01Browse projects through project:// URIs
  2. 02Read project names, paths, and metadata
  3. 03Create text projects
  4. 04Open projects programmatically

Use cases

  1. 01Inspect available projects from an AI client
  2. 02Create a project with a title and content
  3. 03Ask an AI client to open a project

MCP support

The server exposes project resources and create_project and open_project tools to MCP clients.

Configuration

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

mcp.json · Universal config
{
  "mcpServers": {
    "demo-mcp-server-xu1211": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

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

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": []
    }
}

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.