MCP Server Starter
MCP 服务器启动器
使用 TypeScript 构建模型上下文协议 (MCP) 服务器的生产就绪入门模板。
🚀 快速入门
克隆存储库
安装依赖项:
bun install
Related MCP server: MCP TypeScript Server Template
✨ 主要特点
用于快速测试和开发的 Bun
Biome 用于 linting 和格式化
使用标准版本进行自动化版本管理
干净、可维护的项目结构
📂 项目结构
mcp-starter/
├── src/
│ ├── tools/ # MCP tools implementation
│ ├── utils/ # Shared utilities
│ ├── main.ts # Server entry point
│ └── types.ts # Shared type definitions
├── tests/ # Test files
├── biome.json # Linting configuration
├── tsconfig.json # TypeScript configuration
└── package.json # Project dependencies⚙️ 配置
创建新工具
该项目包括一个帮助创建新 MCP 工具的脚本:
bun run scripts/create-tool.ts <tool-name>这将:
在
src/tools/<tool-name>下创建一个新的工具目录生成基本工具结构包括:
index.ts(主要实现)
schema.ts(工具参数的 JSON 架构)
test.ts(测试文件)
更新工具索引文件以导出新工具
例子:
bun run scripts/create-tool.ts weather🛠️ 开发
运行测试:
bun test格式代码:
bun run formatLint 代码:
bun run lint构建项目:
bun run build
要将您的开发 MCP 服务器添加到 Claude Desktop:
构建项目:
bun run build添加到您的 Claude 桌面配置:
// You only need the argument if you need to pass arguments to your server { "mcpServers": { "your-server-name": { "command": "node", "args": ["/path/to/your/project/dist/main.js", "some_argument"] } } }
📜 版本管理
本项目使用standard-version进行自动化版本管理。运行bun run release即可创建新版本。
提交消息格式
feat:新功能(提升小版本)fix:错误修复(补丁版本)BREAKING CHANGE:重大变更(重大版本更新)
📦 发布到 npm
确保您已登录 npm:
npm login构建项目:
bun run build发布包:
npm publish
在发布新版本之前,请记住使用bun run release更新版本号。
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Weather MCP Server Starter:
npx -y @smithery/cli install @GreatAuk/mcp-weather --client claude从 npm 安装(发布后)
添加到您的 Claude 桌面配置:
// You only need the argument if you need to pass arguments to your server
{
"mcpServers": {
"your-server-name": {
"command": "npx",
"args": ["-y", "your-package-name", "some_argument"]
}
}
}Available Tools
1 toolhello_toolD
Hello tool
Inputs: name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools, as there are no other tools to compare it against. The single tool's purpose is clearly distinct by default.
The naming pattern cannot be inconsistent with only one tool, as there is no variation to assess. The tool name 'hello_tool' follows a simple noun-based pattern, which is inherently consistent in this minimal set.
A single tool is too few for a server named 'MCP Server Starter', which implies a foundational or example server that should demonstrate more functionality. This minimal count feels thin and inadequate for the apparent scope of providing starter capabilities.
The tool surface is severely incomplete, as a 'starter' server with only a 'hello_tool' lacks any meaningful operations for building or demonstrating MCP functionality. There are obvious gaps, with no coverage of core MCP workflows or example use cases.
Maintenance
Related MCP Connectors
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
Primarily to be used as a template repository for developing MCP servers with FastMCP in Python, P…
Kickstart development with a customizable TypeScript template featuring sample tools for greeting,…
Related MCP Servers
- AlicenseCqualityDmaintenanceA production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.147MIT
- AlicenseNot gradedqualityDmaintenanceA template repository for building Model Context Protocol (MCP) servers with TypeScript, featuring full TypeScript support, testing setup, CI/CD pipelines, and modular architecture for easy extension.Creative Commons Attribution Non Commercial Share Alike 4.0 International
- AlicenseNot gradedqualityDmaintenanceA TypeScript template for building Model Context Protocol servers that provides a structured foundation with automated tools, testing, and synchronization capabilities.Creative Commons Attribution Non Commercial Share Alike 4.0 International
- AlicenseNot gradedqualityBmaintenanceA starter template for building remote Model Context Protocol servers using TypeScript, providing modern tooling and best practices while leveraging the MCP TypeScript SDK.61MIT
Appeared in Searches
- List of This Week's 15 Most Popular Free Minecraft Servers
- A customizable and widely supported Minecraft server
- Enhancing Prompt Engineering with MCP
- No-code platforms for application development using TypeScript, JavaScript, Python, with MCP server integration via agentic orchestration
- Setting Up AI Employee Tools on Docker Containers with MCP Servers