TypeSpec based local TODO MCP Server

by achandmsft

190 downloads
Not rated
GitHub

About

A simple TODO MCP server fully vibecoded using the TypeSpec MCP Server with GitHub Copilot and OpenAI GPT 4.1

Details

Author
achandmsft
Downloads
190
Categories
Productivity

- Fully vibecoded using TypeSpec MCP Server Demo Script
- Integrates with GitHub Copilot Agent mode in VS Code
- Exposes TODO management as MCP tools
- Built with Node.js (v22+) and TypeSpec
- Supports MCP Inspector for debugging

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name TypeSpec based local TODO MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies (npm install), build the project (npm run build), then start the server (npm run mcp). In VS Code, configure .vscode/mcp.json to point to dist/src/mcp-server.js and start the server; then switch GitHub Copilot to Agent mode and ask it to list todos.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "typespec based local todo mcp server": {
            "Local TODO MCP Server": {
                "command": "node",
                "args": [
                    "${workspaceFolder}/dist/src/mcp-server.js"
                ]
            }
        }
    }
}

McpServers

{
    "Local TODO MCP Server": {
        "command": "node",
        "args": [
            "${workspaceFolder}/dist/src/mcp-server.js"
        ]
    }
}

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

5. 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"]
}
}
}

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.