MCP Server Starter

Integrations

  • Integrates Biome for code linting and formatting, ensuring consistent code quality in the MCP server implementation.

  • Utilizes Bun for runtime execution and development environment, providing fast testing and execution capabilities for the MCP server.

  • Supports publishing the MCP server as an npm package, allowing for easy distribution and installation in Claude Desktop environments.

MCP サーバー スターター

TypeScript を使用して Model Context Protocol (MCP) サーバーを構築するための、本番環境対応のスターター テンプレート。

🚀 クイックスタート

  1. リポジトリをクローンする
  2. 依存関係をインストールします:
    bun install

✨ 主な特徴

  • 高速テストと開発のためのBun
  • リンティングとフォーマットのためのバイオーム
  • 標準バージョンによる自動バージョン管理
  • クリーンで保守しやすいプロジェクト構造

📂 プロジェクト構造

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
  • リントコード: bun run lint
  • プロジェクトのビルド: bun run build

開発用 MCP サーバーを Claude Desktop に追加するには:

  1. プロジェクトをビルドします。
    bun run build
  2. Claude Desktop の設定に追加:
    // 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を使用してバージョン番号を更新することを忘れないでください。

npmからインストールする(公開後)

Claude Desktop の設定に追加:

// 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

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

TypeScript を使用してモデル コンテキスト プロトコル サーバーを構築するための、本番環境対応のテンプレートです。迅速な開発のための Bun、リンティングのための Biome、MCP ツールを作成するための組織化された構造を備えています。

  1. 🚀 クイックスタート
    1. ✨ 主な特徴
      1. 📂 プロジェクト構造
        1. ⚙️ 構成
          1. 新しいツールの作成
        2. 🛠️ 開発
          1. 📜 バージョン管理
            1. コミットメッセージの形式
          2. 📦 npm への公開
            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
                A
                license
                A
                quality
                A TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.
                Last updated -
                1
                7
                2
                TypeScript
                MIT License
              • -
                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

              ID: hzy4o0tbta