MCP Server - TypeScript

A production-ready Model Context Protocol (MCP) server built with TypeScript.

Features

Tools: Execute actions (add, echo, timestamp)
Resources: Access data (server info, greetings, data by ID)
Prompts: Reusable prompt templates (analyze, code-review, summarize)

Project Structure

mcp-server/ ├── src/ │ ├── index.ts # Main server entry point │ ├── tools/ # Tool implementations │ │ └── index.ts │ ├── resources/ # Resource handlers │ │ └── index.ts │ ├── prompts/ # Prompt templates │ │ └── index.ts │ └── utils/ # Helper functions │ └── helpers.ts ├── build/ # Compiled output (generated) ├── .env.example # Environment template ├── .gitignore ├── package.json ├── tsconfig.json └── README.md

Installation

cd mcp-server npm install

Configuration

Copy .env.example to .env:
cp .env.example .env
Edit .env with your configuration:
SERVER_NAME=mcp-server SERVER_VERSION=1.0.0

Development

Build and run the server:

npm run build npm run dev

Testing with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "mcp-server": { "command": "node", "args": ["/absolute/path/to/mcp-server/build/index.js"] } } }

Available Capabilities

Tools

add - Add two numbers
echo - Echo text back
timestamp - Get current timestamp

Resources

info://server - Server information
greeting://{name} - Personalized greeting
data://{id} - Data by ID

Prompts

analyze - Analysis prompt template
code-review - Code review prompt template
summarize - Summarization prompt template

Production Deployment

Build the project:
npm run build
The compiled server is in build/index.js
Run with:
node build/index.js

Adding New Capabilities

New Tool

Edit src/tools/index.ts and add:

server.registerTool( 'tool-name', { title: 'Tool Title', description: 'Tool description', inputSchema: { param: z.string().describe('Parameter description'), }, }, async ({ param }) => { // Implementation return { content: [{ type: 'text', text: 'result' }], }; } );

New Resource

Edit src/resources/index.ts and add:

server.registerResource( 'resource-name', new ResourceTemplate('scheme://{param}', { list: undefined }), { title: 'Resource Title', description: 'Resource description', }, async (uri, { param }) => { return { contents: [{ uri: uri.href, text: 'data' }], }; } );

New Prompt

Edit src/prompts/index.ts and add:

server.registerPrompt( 'prompt-name', { title: 'Prompt Title', description: 'Prompt description', }, async () => { return { messages: [ { role: 'user', content: { type: 'text', text: 'prompt text' }, }, ], }; } );

License

MIT

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A production-ready TypeScript MCP server providing basic tools (add, echo, timestamp), resources (server info, greetings, data access), and prompt templates (analyze, code-review, summarize). Serves as a foundation for building custom MCP servers with extensible architecture.

MCP Server TypeScript