Smartsheet Server

🚀 スマートサーバー開発ドキュメント

スマートサーバーは高度にモジュール化されたシステムで、TypeScriptやPythonなどの複数のプログラミング言語での開発をサポートし、MCP（機械学習制御プロトコル）と統一プロトコルで通信します。このサーバーは複雑なデータ操作と業務ロジックの処理に特化して設計されています。

✨ 主な機能

1. 多言語サポート：

   • TypeScriptとPythonのコードをサポートします。
   • 言語間のデータ変換モジュールを提供します。

2. 拡張機構：

   • プラグイン式のアーキテクチャで、機能拡張が容易です。
   • 高い柔軟性とカスタマイズ性を備えています。

3. プロトコル互換性：

   • MCPプロトコルと完全に互換性があります。
   • 長時間接続やポーリングなどの複数の通信モードをサポートします。

4. 性能最適化：

   • 組み込みのデータキャッシュ機構があります。
   • 効率的なタスク処理能力を持っています。

5. エラー処理：

   • 階層化されたエラー処理アーキテクチャを採用しています。
   • 詳細なエラーログ記録を行います。

🚀 クイックスタート

📦 インストール

npm install mcp-server --save
pip install mcp-server

💻 使用例

新しいサービスの作成

1. 新しいTypeScriptモジュールを作成します：

// Calculator.ts
export class Calculator {
    add(a: number, b: number): number {
        return a + b;
    }

    multiply(a: number, b: number): number {
        return a * b;
    }
}

2. 対応するMCP設定ファイルを作成します：

// calculator.json
{
  "name": "Calculator",
  "description": "Basic arithmetic operations.",
  "operations": [
    {
      "name": "add",
      "parameters": [
        { "type": "number", "name": "a" },
        { "type": "number", "name": "b" }
      ],
      "returns": "number"
    },
    {
      "name": "multiply",
      "parameters": [
        { "type": "number", "name": "a" },
        { "type": "number", "name": "b" }
      ],
      "returns": "number"
    }
  ]
}

3. サービスを起動します：

mcp-server calculator.json

高度な使用法

バッチ処理

サーバーはbatchSizeパラメータを使用したバッチ処理をサポートしており、デフォルトは500です。例えば：

const result = await mcpClient.processBatch(batchData, {
  batchSize: 100,
  lenientMode: true
});

マルチスレッドサポート

Pythonバージョンはマルチスレッド処理をサポートしており、threadCountパラメータを設定することでスレッド数を制御できます：

from mcp_server import Server

server = Server(thread_count=5)
server.start()

例：電卓サービス

1. TypeScriptでの実装を作成します：

class Calculator {
    add(a: number, b: number): number {
        return a + b;
    }

    multiply(a: number, b: number): number {
        return a * b;
    }
}

2. MCP設定ファイルを定義します：

{
  "name": "Calculator",
  "description": "Basic arithmetic operations.",
  "operations": [
    {
      "name": "add",
      "parameters": [
        { "type": "number", "name": "a" },
        { "type": "number", "name": "b" }
      ],
      "returns": "number"
    },
    {
      "name": "multiply",
      "parameters": [
        { "type": "number", "name": "a" },
        { "type": "number", "name": "b" }
      ],
      "returns": "number"
    }
  ]
}

3. サービスを起動します：

mcp-server calculator.json

📚 ドキュメント

開発

開発環境の自動再構築：

npm run watch

デバッグ

MCPサーバーは標準入出力を介して通信するため、デバッグは難しい場合があります。サーバーは全面的なエラーログ記録を実装し、MCPプロトコルを通じて詳細なエラー情報を提供します。

主要なデバッグ機能は以下の通りです：

• エラー情報を標準エラーストリームに記録する
• 詳細なMCP応答内のエラー情報
• 多段階の型検証
• 全面的な操作結果レポート
• 列操作の依存関係分析
• 式参照の追跡

エラー処理

サーバーは多層のエラー処理方法を採用しています：

1. MCP層：

   • ツールパラメータの検証
   • プロトコルレベルのエラー処理
   • フォーマットされたエラー応答の提供
   • タイムアウトとリトライの管理

2. CLI層：

   • 入力パラメータの検証
   • コマンドラインエラーの処理
   • ユーザーフレンドリーなエラーメッセージの生成

3. 業務ロジック層：

   • カスタムエラー処理
   • データ検証
   • エラー伝播メカニズム

例：データ変換サービス

1. TypeScriptモジュールを作成します：

class DataConverter {
    toUpperCase(str: string): string {
        return str.toUpperCase();
    }

    reverseString(str: string): string {
        return str.split('').reverse().join('');
    }
}

2. MCP設定ファイルを定義します：

{
  "name": "DataConverter",
  "description": "String manipulation operations.",
  "operations": [
    {
      "name": "toUpperCase",
      // 元のREADMEにこの操作の残りの部分が省略されていたため、そのまま残します
    }
  ]
}