Js MCP Server

🚀 JS MCP サーバー

JavaScriptベースのMCPサーバーコンポーネントで、WebAssembly SDKを統合することで、簡単に使え、迅速にデプロイできます。

🚀 クイックスタート

JS MCPサーバーを使用するには、以下の手順に従ってください。

📦 インストール

git clone https://github.com/justin-echternach/js-mcp-server.git
cd js-mcp-server
npm install -g @bytecodealliance/componentize-js @bytecodealliance/jco
npm install

📦 ビルド

プロジェクトをビルドしてWebAssemblyモジュールを生成するには、以下のコマンドを実行します。

npm run build

これにより、Viteを使用してJavaScriptコードがパッケージ化され、dist/js-mcp-server.wasmファイルが生成されます。

✨ カスタマイズ

サーバーは、ハンドラー（ツールとも呼ばれます）を追加または変更することでカスタマイズできます。ハンドラーはserver.jsファイルにあり、handlersディレクトリに保存されています。新しいハンドラーを追加するには、以下の手順を実行します。

1. handlersディレクトリに新しいJavaScriptファイルを作成し、処理ロジックを実装します。
2. server.jsでハンドラーをインポートします。
3. createMcpServer関数呼び出しのtoolsオブジェクトにハンドラーを追加します。EchoTool、KgTool、FetchDogToolの登録方法を参考にしてください。

例えば、MyToolという名前の新しいツールを追加するには、以下のようにします。

import { myTool } from './handlers/my-tool';

// server.js 内
const server = new MCP.Server({
  tools: {
    ...defaultTools,
    myTool: myTool
  }
});

📚 ハンドラー開発ガイド

各ハンドラーは以下をエクスポートする必要があります。

• id：文字列型で、ツールの一意の識別子です。
• name：文字列型で、ツールの名前です。
• description：文字列型で、ツールの説明です。
• method：関数で、処理ロジックを実装します。

以下はサンプルコードです。

export const myTool = {
  id: 'my-tool-id',
  name: 'My Tool Name',
  description: 'This is a custom tool that does something.',
  method: async (context, parameters) => {
    // 処理ロジック
    return { result: 'processed' };
  }
};

💻 使用例

基本的な使用法

PostgresとHTTPインターフェースの使用

Postgresクエリ

SDKには、データベースをクエリする関数が用意されています。例えば以下の通りです。

import { query } from '../sdk/database';

export async function handleDatabaseQuery(context, parameters) {
  try {
    const result = await query('SELECT * FROM my_table WHERE id = $1', [parameters.id]);
    return { data: result };
  } catch (error) {
    return { error: error.message };
  }
}

HTTPクライアント

SDKには、便利なHTTPクライアントメソッドが用意されています。

import { get, post } from '../sdk/http';

export async function fetchData(context, parameters) {
  try {
    const response = await get('https://api.example.com/data', {
      headers: {
        'Authorization': `Bearer ${parameters.token}`
      }
    });
    return { data: response.body };
  } catch (error) {
    return { error: error.message };
  }
}

高度な使用法

ベストプラクティス

• エラーハンドリング：常にtry/catchで敏感なコードブロックを囲み、例外を適切に捕捉して処理します。
• 入力検証：すべての外部入力を厳密に検証し、クリーニングして、潜在的なセキュリティホールを防止します。
• パフォーマンス最適化：ハンドラー内で高コストの操作を実行するのを避け、非同期処理や並列実行を検討します。
• ドキュメント化：各ツールについて、入力パラメーター、出力形式、および潜在的なエラー状況を含む詳細なドキュメントを提供します。

これらのベストプラクティスに従うことで、効率的で安全かつ保守しやすいJS MCPサーバーを構築できます。