MCP server quickstart

Repo level instructions have precedence over this generic skill.

Server skeleton

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({
  name: "md-vision",
  version: "0.1.0",
});

// server.tool(...) or server.registerTool(...) — match whichever API the installed SDK exposes

async function main(): Promise<void> {
  const transport = new StdioServerTransport();
  await server.connect(transport);
}

main().catch((err) => {
  console.error(err);
  process.exit(1);
});

stdio rules:

• Never write to stdout except MCP protocol messages. Use `console.error` for logs.
• The host starts the process and owns stdin/stdout; no listening port.
• bin in package.json points at ./dist/server.js; run npm run build before testing.

Tool design

→ See references/tool-design.md for description and schema guidance.

Security

Restrict paths and domains via CLI flags. Block filesystem and network access by default if no flags are provided. MCP Roots is deprecated in the next MCP standard — do not use it here.