MCP Server Starter

MCP Server Starter

site icon
2025.02.17 2
TypeScriptMCP服务器模板TypeScript开发其它
mcp-weather 是一个基于 TypeScript 的 Model Context Protocol (MCP) 服务器模板,专为快速构建生产就绪的 MCP 服务器而设计。它提供了高效的开发工具链、自动化版本管理和清晰的项目结构,适合开发者快速启动 MCP 服务器项目。
View on GitHub

Overview

基本能力

产品定位

mcp-weather 是一个生产就绪的 MCP 服务器模板,旨在帮助开发者快速构建和部署 MCP 服务器。

核心功能

  • 快速开发和测试:使用 Bun 进行高效的测试和开发。
  • 代码质量和一致性:集成 Biome 进行代码格式化和 linting。
  • 自动化版本管理:通过 standard-version 自动化版本控制和变更日志生成。
  • 清晰的项目结构:提供模块化的目录结构,便于维护和扩展。
  • 工具创建支持:提供脚本快速创建新的 MCP 工具。

适用场景

  • 开发者需要快速启动一个新的 MCP 服务器项目。
  • 团队需要标准化的项目结构和开发流程。
  • 需要自动化版本管理和发布流程的项目。

工具列表

  • create-tool.ts:用于快速创建新的 MCP 工具,包括生成工具目录、实现文件、测试文件和更新导出索引。

常见问题解答

  • 如何创建新工具? 使用 bun run scripts/create-tool.ts <tool-name> 命令。
  • 如何运行测试? 使用 bun test 命令。
  • 如何格式化代码? 使用 bun run format 命令。

使用教程

使用依赖

  1. 确保已安装 Bun 运行时环境。

安装教程

  1. 克隆仓库。
  2. 安装依赖: bash bun install

调试方式

  • 运行测试bun test
  • 格式化代码bun run format
  • lint 代码bun run lint
  • 构建项目bun run build

添加到 Claude Desktop

  1. 构建项目: bash bun run build
  2. 在 Claude Desktop 配置中添加: json { "mcpServers": { "your-server-name": { "command": "node", "args": ["/path/to/your/project/dist/main.js", "some_argument"] } } }

发布到 npm

  1. 登录 npm: bash npm login
  2. 构建项目: bash bun run build
  3. 发布包: bash npm publish

通过 Smithery 安装

npx -y @smithery/cli install @GreatAuk/mcp-weather --client claude

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。