TypeScript MCP Demo Server
@gedankrayze
About TypeScript MCP Demo Server
MCP Server Template for Bun Developers
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"ts-demo-mcp": {
"command": "bun",
"args": [
"start"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is TypeScript MCP Demo Server?
A basic Model Context Protocol (MCP) server implementation using the TypeScript SDK and Bun runtime. It demonstrates server initialization with stdio transport, tool registration, and TypeScript type safety, intended for developers learning to build MCP servers.
How to use TypeScript MCP Demo Server?
Clone the repository, install dependencies with bun install, then start the server using bun start or task start. For Claude Desktop integration, add the provided configuration to your Claude Desktop config. Optionally use task inspect-server for debugging via the MCP inspector.
Key features of TypeScript MCP Demo Server
- Implementation with TypeScript SDK and Bun runtime
- Stdio transport for server-client communication
- Two example tools: greet and add_numbers
- TypeScript strict mode for type safety
- Integration with Claude Desktop via MCP protocol
- MCP inspector support for debugging
Use cases of TypeScript MCP Demo Server
- Learning how to build and structure an MCP server in TypeScript
- Testing MCP tool registration and handling with a minimal demo
- Integrating a custom MCP server with Claude Desktop for proof-of-concept
- Exploring the MCP inspector for server capability debugging
FAQ from TypeScript MCP Demo Server
What runtime does TypeScript MCP Demo Server require?
It requires Bun (latest version). Task is optional for using the task runner.
What tools does the server provide?
Two tools: greet which takes a name string and returns a greeting, and add_numbers which takes two numbers and returns their sum.
How do I add new tools to the server?
Add a new tool definition in the ListToolsRequestSchema handler and implement its logic in the CallToolRequestSchema handler, following the provided example.
What transport does this server use?
It uses stdio transport, as specified in the server initialization and the Claude Desktop configuration example.
Where can I find the source code and documentation?
The project is hosted at https://github.com/gedankrayze/ts-demo-mcp. Additional MCP resources are linked in the README.
More Other MCP servers
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
Comments