Nekzus MCP Server

🚀 MCP サーバー

MCP サーバーは、様々な便利なツールを提供するプラットフォームです。ユーザーは、さまざまなツールを呼び出すことで特定のタスクを実行できます。

🚀 クイックスタート

MCP サーバーを使用するには、まずグローバルにインストールし、その後サーバーを起動します。具体的な手順は以下の通りです。

グローバルインストール

ターミナルで以下のコマンドを実行して、グローバルにインストールします。

npm install -g @nekzus/mcp-server

サーバー起動

インストールが完了したら、以下のコマンドで MCP サーバーを起動します。

npx @nekzus/mcp-server

✨ 主な機能

• 多ツールサポート：様々な機能モジュールを統合し、さまざまなニーズに対応します。
• 入力検証：Zod を使用して厳格な入力検証を行います。
• エラー処理：完全な例外捕捉とリソースクリーンアップメカニズムを備えています。
• シグナル処理：SIGTERM と SIGINT シグナルをサポートし、エレガントなシャットダウンを実現します。

📦 インストール

グローバルインストール

npm install -g @nekzus/mcp-server

開発用のインストール

リポジトリのクローン

ターミナルで以下のコマンドを実行して、プロジェクトリポジトリをクローンします。

git clone https://github.com/nekzus/mcp-server.git

依存関係のインストール

プロジェクトディレクトリに移動した後、すべての依存パッケージをインストールします。

npm install

💻 使用例

基本的な使用法

単位変換

// 1 アメリカ杯をミリリットルに変換
{
  "value": 1,
  "from": "cup",
  "to": "ml"
}

返却結果:

{
  "result": 236.59,
  "unit": "ml"
}

時間フォーマット

// Unix タイムスタンプ 1672598400 を人間が読みやすい形式に変換
{
  "timestamp": 1672598400,
  "format": "YYYY-MM-DD HH:mm:ss"
}

返却結果:

{
  "formattedDate": "2023-01-01 00:00:00"
}

データ統計

// 配列 [1, 2, 3, 4, 5] の基本情報を統計
{
  "data": [1, 2, 3, 4, 5]
}

返却結果:

{
  "maxValue": 5,
  "minValue": 1,
  "average": 3,
  "sum": 15
}

📚 ドキュメント

開発モード

以下のコマンドを使用して開発サーバーを起動します。

npm run dev

プロジェクトのビルド

以下のコマンドを実行してプロジェクトをビルドします。

npm run build

サービスの実行

ビルドが完了したら、以下のコマンドでサービスを実行します。

npm start

プロジェクト構造

プロジェクトのディレクトリ構造は以下の通りです。

src/
├── types/          # 型定義フォルダ
│   └── index.ts    # 共通型定義
├── utils/          # ユーティリティ関数フォルダ
│   ├── cards.ts    # カード関連機能
│   ├── datetime.ts # 日付時間処理
│   └── schema.ts   # データ検証スキーマ
├── tools/          # 各ツールの実装フォルダ
│   └── index.ts    # ツール登録センター
└── index.ts        # プログラムのエントリポイント

🔧 技術詳細

• 通信プロトコル：StdioServerTransport を使用してプロセス間通信を実現します。
• データ検証：JSON 検証スキーマを Zod モデルに変換して検証します。
• 型安全：全体を通じて TypeScript を使用して静的型チェックを行います。
• エラー処理：完全な例外捕捉とリソースクリーンアップメカニズムを備えています。
• シグナル処理：SIGTERM と SIGINT シグナルをサポートし、エレガントなシャットダウンを実現します。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。

連絡先

フィードバックや協力に関しては、以下の方法でご連絡ください。

• メール：support@nekzus.com
• 公式サイト：https://mcp.nekzus.com