Github Issue MCP Server

🚀 GitHub Server MCP Server

A TypeScript-based MCP server that implements a simple note-taking system. It demonstrates core MCP concepts through the following features:

• Resources: List and access text notes via note:// URIs. Each note includes a title, content, and metadata.
• Tools: Create new notes.
• Prompts: Generate summaries of all stored notes.

🚀 Quick Start

This is a TypeScript-based MCP server that implements a straightforward note system. It showcases the core MCP concepts through the following functionalities.

✨ Features

Resources

• List and access notes via note:// URIs.
• Each note has a title, content, and metadata.
• Use a simple plain-text MIME type for content access.

Tools

• create_note - Create a new text note.
  • Accepts a title and content as required parameters.
  • Stores the note in the server state.

Prompts

• summarize_notes - Generate a summary of all stored notes.
  • Includes all note content as embedded resources.
  • Returns a structured prompt for the LLM to summarize.

📦 Installation

Install Dependencies

npm install

Build the Server

npm run build

Development with Automatic Rebuild

npm run watch

Configuration for Claude Desktop

To use it with Claude Desktop, add the server configuration:

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

{
  "mcpServers": {
    "github-server": {
      "command": "/path/to/github-server/build/index.js"
    }
  }
}

Debugging

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

npm run inspector

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