MCP Async Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

MCP 非同期サーバー

🚀 堅牢なステータス追跡とエラー処理を備えた非同期タスク処理を示す高性能なモデルコンテキストプロトコル (MCP) サーバー実装。


✨ 特徴

  • 🔄非同期タスク処理- 長時間実行される操作を効率的に処理します
  • 📊リアルタイムステータストラッキング- ポーリングサポートでタスクの進行状況を監視
  • 🧹自動リソース管理- スマートなタスクのクリーンアップとメモリ管理
  • ⏱️タイムアウト処理- タスクのタイムアウトを設定可能
  • 🛡️堅牢なエラー処理- カスタムエラータイプと包括的なエラーレポート
  • 📝 TypeScript サポート- 完全な型安全性と最新の JavaScript 機能
  • 🔍組み込みのインスペクター- MCP サーバーを簡単にデバッグおよびテストできます

🚀 クイックスタート

前提条件

  • Node.js 20.x 以上
  • npm 9.x以上

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Async MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @ViezeVingertjes/example-async-mcp --client claude

インストール

# Clone the repository git clone https://github.com/ViezeVingertjes/example-async-mcp.git # Navigate to the project directory cd example-async-mcp # Install dependencies npm install # Build the project npm run build

サーバーの実行

npm start

インスペクタの使用

npm run inspector

📖 APIリファレンス

利用可能なツール

process_task

新しい非同期タスクを作成します。

{ "name": "process_task", "arguments": { "input": "Hello, World!", "delayMs": 5000, "timeoutMs": 30000 } }
パラメータタイプ必須デフォルト説明
入力-処理する入力文字列
遅延Ms番号5000処理遅延(ミリ秒)
タイムアウトMs番号30000タスクのタイムアウト(ミリ秒)

check_task_status

既存のタスクのステータスを確認します。

{ "name": "check_task_status", "arguments": { "taskId": "550e8400-e29b-41d4-a716-446655440000" } }
パラメータタイプ必須説明
タスクIDチェックするタスクのID

タスクの状態

状態説明
🕒 pendingタスクは作成されましたが、開始されていません
processingタスクを処理中です
completeタスクは正常に完了しました
errorタスクが失敗しました

⚙️ 構成

src/constants.tsの主な設定オプション:

export const DEFAULT_TASK_TIMEOUT_MS = 30000; // 30 seconds export const DEFAULT_TASK_DELAY_MS = 5000; // 5 seconds export const DEFAULT_POLL_DELAY_MS = 10000; // 10 seconds export const POLL_INTERVAL_MS = 100; // 100ms export const MAX_TASKS = 1000; // Maximum concurrent tasks

🛠️ 開発

プロジェクト構造

src/ ├── index.ts # Main server implementation ├── types.ts # TypeScript types and interfaces ├── constants.ts # Configuration constants └── utils.ts # Utility functions

開発コマンド

# Build the project npm run build # Watch for changes npm run watch # Run tests npm test # Run inspector npm run inspector

📝 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。


-
security - not tested
A
license - permissive license
-
quality - not tested

このサーバーは、リアルタイムのステータス追跡、堅牢なエラー処理、自動リソース管理を備えた非同期タスクを処理するために、モデル コンテキスト プロトコル (MCP) を実装します。

  1. ✨ Features
    1. 🚀 Quick Start
      1. Prerequisites
      2. Installing via Smithery
      3. Installation
      4. Running the Server
      5. Using the Inspector
    2. 📖 API Reference
      1. Available Tools
      2. Task States
    3. ⚙️ Configuration
      1. 🛠️ Development
        1. Project Structure
        2. Development Commands
      2. 📝 License
        ID: k2os9maqr0