hybrid server

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

Integrations

Used for linting and formatting in the project
Used for fast testing and development in the project
The project can be published to npm registry

MCP サーバースターター

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

🚀 クイックスタート

リポジトリをクローンする
依存関係をインストールします:
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>

これにより、次のようになります。

src/tools/<tool-name>の下に新しいツールディレクトリを作成します。
以下を含む基本的なツール構造を生成します。
- index.ts (メイン実装)
- schema.ts (ツールパラメータのJSONスキーマ)
- test.ts (テストファイル)
新しいツールをエクスポートするためにツールのインデックスファイルを更新します

例：

bun run scripts/create-tool.ts weather

🛠️ 開発

テストを実行: bun test
フォーマットコード: bun run format
リントコード: bun run lint
プロジェクトのビルド: bun run build

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

プロジェクトをビルドします。
bun run build
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 への公開

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

Tools

hello_tool

モデルコンテキストプロトコルサーバーを構築するための TypeScript ベースのテンプレートで、高速テスト、自動バージョン管理、MCP ツール実装用のクリーンな構造が特徴です。

Related Resources

Reddit Discussion about this server