TypeSpec based local TODO MCP Server

TypeSpec based local TODO MCP Server

A TODO MCP server fully vibecoded using the TypeSpec MCP Server Demo Script in GitHub Copilot Agent mode with OpenAI GPT 4.1 model.

Prerequisites

1. Install VS Code
2. Install GitHub Copilot and GitHub Copilot Chat extensions
3. Install NodeJS (needs v22+)

Setup Instructions

1. Clone the repository:

   git clone https://github.com/achandmsft/typespec-mcp-todo.git
   

2. Install dependencies: Run the following command to install all required dependencies:

   npm install
   

3. Build the project: Build the TypeSpec and TypeScript files using:

   npm run build
   

4. Start the server: Start the MCP server with:

   npm run mcp
   

5. Inspect the server (optional): Use the MCP Inspector to inspect the server:

   npm run inspect
   

6. Use the server in VSCode with GitHub Copilot Agent Mode (optional): Go to .vscode/mcp.json. Click Start. Switch GitHub Copilot to Agent mode. Ask it to "list todos" which should now use a tool from this server:

{
"servers": {
   /*Click Start here in VSCode*/
    "Local TODO MCP Server": {
      "command": "node",
      "args": ["${workspaceFolder}/dist/src/mcp-server.js"]
    }
  }
}