demo-mcp-server MCP Server

By xu1211 GitHub

Overview

what is demo-mcp-server?

The demo-mcp-server is a Model Context Protocol (MCP) server built with TypeScript, designed to demonstrate core concepts through a project management system.

how to use demo-mcp-server?

To use the demo-mcp-server, install the necessary dependencies, build the server, and configure it with your application. You can create and open projects programmatically using the provided tools.

key features of demo-mcp-server?

List and access projects via project:// URIs.
Create new text projects with the create_project tool.
Open existing projects using the open_project tool.
Debugging support through the MCP Inspector.

use cases of demo-mcp-server?

Managing and organizing projects in a structured manner.
Programmatically creating and accessing project resources.
Integrating with applications like Claude Desktop for enhanced project management.

FAQ from demo-mcp-server?

What is the purpose of the demo-mcp-server?

It serves as a demonstration of the Model Context Protocol and its application in project management.

How do I install the demo-mcp-server?

Follow the installation instructions provided in the documentation, including adding the server config to your application.

Can I debug the demo-mcp-server?

Yes, you can use the MCP Inspector for debugging, which provides tools accessible via a browser.

Content

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

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

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

No tools information available.

No content found.