This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
A production-ready Model Context Protocol server in TypeScript, ready to customize with coding agents. It runs over stdio for local clients and Streamable HTTP for remote ones, with OAuth, tests through real MCP clients, and a release pipeline.
Current protocol: built on the official MCP SDK v2, for the 2026-07-28 spec, while still serving older clients.
Two transports: stdio for Claude Code, Claude Desktop, and Cursor, plus stateless Streamable HTTP that scales horizontally.
Secure HTTP: OAuth per the MCP authorization spec, or static tokens. It won't start without an auth mode, and it blocks DNS rebinding.
Sample tools: get_time, search_docs, and whoami, with input and output schemas, annotations, and readable errors, plus docs:// resources.
Backend integration: list_notes and create_note call a REST API with timeouts, validated responses, and errors the model can act on. See Connect a backend API.
Real tests: every tool is tested through a real MCP client over HTTP and stdio, on both protocol eras.
Publishing: releases to npm, the MCP Registry, and GHCR, with a test that keeps server.json and package.json in step.
Agent-ready: AGENTS.md, skills, and checks that run on every commit.
Related MCP server: MCP TypeScript Template
You need Node 26 or later and pnpm:
git clone https://github.com/opikdev/mcp-server-ts-starter
cd mcp-server-ts-starter
pnpm install
pnpm inspectThe MCP Inspector opens in your browser. Connect, list the tools, and call get_time.
To run it over HTTP in Docker instead:
docker compose up --build --wait mcpThe server is now at http://localhost:3000/mcp, with the dev token dev-token-change-me-0123.
Task | Command |
Try the tools in the MCP Inspector |
|
Serve over HTTP on your machine |
|
Run lint, types, tests, and repo checks |
|
Test the built package and Docker image |
|
Build the npm package |
|
To use the server from Claude Code, Claude Desktop, Cursor, or VS Code, see Connect a client. Before you serve over HTTP outside your machine, read Configure HTTP auth. To ship a release, see Publish a release.
To add a tool, create a file in src/tools/ like src/tools/time.ts, register it in src/server.ts, and add tests to test/integration/tools.test.ts.
Path | Purpose |
| One file per tool |
| Resources and their data |
| Clients for backend APIs the tools call |
| The HTTP app, auth gate, and server startup |
| OAuth and static token verifiers |
| Unit, integration, and end-to-end tests |
| Architecture, guides, and decisions |
Read CONTRIBUTING.md before opening a pull request, and follow the code of conduct.
Report vulnerabilities privately, as described in SECURITY.md.
Released under the MIT License.
This server cannot be deployed
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
