Skip to main content
Glama

MCP Server Starter

by GreatAuk

MCP 服务器启动器

使用 TypeScript 构建模型上下文协议 (MCP) 服务器的生产就绪入门模板。

🚀 快速入门

  1. 克隆存储库
  2. 安装依赖项:
    bun install

✨ 主要特点

  • 用于快速测试和开发的 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>

这将:

  1. src/tools/<tool-name>下创建一个新的工具目录
  2. 生成基本工具结构包括:
    • index.ts(主要实现)
    • schema.ts(工具参数的 JSON 架构)
    • test.ts(测试文件)
  3. 更新工具索引文件以导出新工具

例子:

bun run scripts/create-tool.ts weather

🛠️ 开发

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

要将您的开发 MCP 服务器添加到 Claude Desktop:

  1. 构建项目:
    bun run build
  2. 添加到您的 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

  1. 确保您已登录 npm:
    npm login
  2. 构建项目:
    bun run build
  3. 发布包:
    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"] } } }

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

用于构建模型上下文协议服务器的基于 TypeScript 的模板,具有快速测试、自动版本管理和用于 MCP 工具实现的清晰结构。

  1. 🚀 快速入门
    1. ✨ 主要特点
      1. 📂 项目结构
        1. ⚙️ 配置
          1. 创建新工具
        2. 🛠️ 开发
          1. 📜 版本管理
            1. 提交消息格式
          2. 📦 发布到 npm
            1. 通过 Smithery 安装
              1. 从 npm 安装(发布后)

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  A production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.
                  Last updated -
                  1
                  7
                  12
                  JavaScript
                  MIT License
                • A
                  security
                  A
                  license
                  A
                  quality
                  A production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
                  Last updated -
                  1
                  7
                  JavaScript
                  MIT License
                • A
                  security
                  F
                  license
                  A
                  quality
                  A template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.
                  Last updated -
                  1
                  5
                  TypeScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.
                  Last updated -
                  67
                  TypeScript
                  • Apple

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/GreatAuk/mcp-weather'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server