Skip to main content
Glama
MCP Server Starter

MCP Server Starter

by dao77777

MCP Server Starter

A minimal Model Context Protocol (MCP) server with 3 tools, Zod input schemas, tests and Docker.

This is the kind of server an AI coding agent can call to work with an issue tracker: list issues, read one issue, and add a comment.

Tools

Tool

Input

What it does

list_issues

status?: open | closed | all, limit?: 1..50

List issues

get_issue

id: number

Get one issue with comments

add_comment

id, body, author?

Add a comment

Related MCP server: mcp-issue-tracker

Quickstart

pnpm install
pnpm demo          # terminal demo, no MCP client needed
pnpm dev           # run the MCP server over stdio
pnpm check         # typecheck + tests

The server speaks MCP over stdio. Point any MCP-compatible client at pnpm dev (or the built node dist/src/server.js).

Example tool call

{
  "name": "list_issues",
  "arguments": { "status": "open", "limit": 5 }
}
[
  {
    "id": 101,
    "title": "Agent stops after a tool error instead of retrying",
    "status": "open",
    "labels": ["agent", "reliability"]
  }
]

Why this repo exists

It is a compact reference for:

  • registering MCP tools with typed Zod schemas

  • separating pure store logic from the transport

  • testing tool behavior without an LLM

  • shipping a stdio server with Docker and CI

Structure

src/store.ts     in-memory issue tracker + pure functions
src/server.ts    MCP server + tool registration
scripts/demo.ts  terminal demo
test/            Vitest tests

Docker

docker build -t mcp-server-starter .
docker run --rm -i mcp-server-starter

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with a local SQLite-backed issue tracker, offering full CRUD operations (search, fetch, summarize, create, comment, close/reopen) with team-scoped visibility, authorization, rate limiting, and audit logging.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables compatible agents to call registered local tools and read resources through one stdio server, including harness preparation, knowledge search and document management, memory retention/recall, correction proposals, advisory decisions, tool/skill discovery, and log/source inspection.
      2
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Exposes the customer-support tool registry over stdio so Claude Desktop or Claude Code can look up customers and orders, track shipments, search help-center articles, update shipping addresses, issue policy-checked refunds and escalate to a human. It reuses the same pydantic validation, ownership and refund policy, approval gate and audit logging as the HTTP agent, with the customer identity taken from server configuration rather than the model.
      7
      MIT