Skip to main content
Glama

MCP 服务器启动器

铁匠徽章

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

🚀 快速入门

  1. 克隆存储库

  2. 安装依赖项:

    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>

这将:

  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"]
    }
  }
}

Available Tools

1 tool
hello_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

    C2/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness1/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      A starter template for building remote Model Context Protocol servers using TypeScript, providing modern tooling and best practices while leveraging the MCP TypeScript SDK.
      61
      MIT