MCPサーバーとは？

MCPサーバーは、言語モデルにコンテキストデータと機能サポートを提供するための標準化されたアプリケーションインターフェースです。リソース、ツール、プロンプトテンプレートを通じて人間との対話を実現し、開発者が効率的で安全なAIアプリケーションを簡単に構築できるようにします。

MCPサーバーの使い方は？

MCPサーバーは、簡単なインストールと設定ですぐに起動できます。カスタムツール、リソース、プロンプトテンプレートを作成して、具体的なニーズに対応できます。サーバーは、標準入出力やHTTP SSEなどの複数の伝送プロトコルをサポートしています。

適用シナリオ

MCPサーバーは、動的データのロード、外部機能の呼び出し、対話型会話が必要なシナリオに広く適用されます。例えば、スマート客服、知識管理システム、自動化開発ツールなどです。

主な機能

リソース管理静的または動的なリソースを定義して、言語モデルにコンテキストデータを提供できます。

ツール統合計算、データベースクエリなどの複雑なタスクを実行するツールの作成とデプロイをサポートします。

プロンプトテンプレート事前定義されたプロンプトテンプレートを使用して、言語モデルがユーザーの意図をよりよく理解できるようにします。

複数の伝送プロトコルstdioやHTTP SSEなどの複数の通信方式をサポートし、さまざまなクライアントとの接続を容易にします。

利点と制限

利点

統一されたインターフェース標準で、開発プロセスを簡素化します。

多くのシナリオでのアプリケーションをサポートし、高い柔軟性を持ちます。

強力な拡張機能で、必要に応じて機能をカスタマイズできます。

制限

高度な機能を使用するには、一定のプログラミング基礎が必要になる場合があります。

一部のツールのパフォーマンスは、バックエンドの実装効率に依存します。

使い方

MCP SDKをインストールする

次のコマンドを実行して、MCP TypeScript SDKをインストールします：`npm install @modelcontextprotocol/sdk`。

MCPサーバーを初期化する

新しいMCPサーバーインスタンスを作成し、名前やバージョンなどの基本情報を設定します。

リソース、ツール、プロンプトテンプレートを追加する

必要に応じてリソース、ツール、プロンプトテンプレートを定義し、アプリケーションシナリオに対応できるようにします。

伝送層に接続する

適切な伝送プロトコル（stdioやHTTP SSEなど）を選択して、クライアントに接続します。

使用例

電卓ツール簡単な足し算ツールを実装して、ツール機能をデモンストレーションします。

SQLiteデータベースクエリSQLiteデータベースクエリツールを使用して、ユーザー情報を取得します。

よくある質問

MCPサーバーは多言語環境をサポートしていますか？

MCPサーバーをどのようにデバッグしますか？

🚀 MCP TypeScript ソフトウェア開発キット（SDK）ドキュメント

MCP TypeScript SDK は、Model Context Protocol（MCP）を使用して開発を行うための便利なツールです。この SDK を利用することで、MCP サーバーやクライアントを簡単に構築することができます。

🚀 クイックスタート

📦 インストール

npm を使用したインストール

以下のコマンドを使用して、npm 経由で MCP TypeScript SDK をインストールできます。

npm install @modelcontextprotocol/typescript-sdk

💻 使用例

基本的な使用法

MCP サーバーの作成

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "example-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

server.setRequestHandler(ListPromptsRequestSchema, async () => {
  return {
    prompts: [{
      name: "example-prompt",
      description: "An example prompt template",
      arguments: [{
        name: "arg1",
        description: "Example argument",
        required: true
      }]
    }]
  };
});

server.setRequestHandler(GetPromptRequestSchema, async (request) => {
  if (request.params.name !== "example-prompt") {
    throw new Error("Unknown prompt");
  }
  return {
    description: "Example prompt",
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: "Example prompt text"
      }
    }]
  };
});

const transport = new StdioServerTransport();
await server.connect(transport);

MCP クライアントの作成

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "node",
  args: ["server.js"]
});

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

await client.connect(transport);

// 列举提示
const prompts = await client.listPrompts();

// 获取一个提示
const prompt = await client.getPrompt("example-prompt", {
  arg1: "value"
});

// 列举资源
const resources = await client.listResources();

// 读取资源
const resource = await client.readResource("file:///example.txt");

// 调用工具
const result = await client.callTool("example-tool", {
  arg1: "value"
});

高度な使用法

低レベルサーバークラスの使用

もしより細かい制御が必要な場合は、低レベルの Server クラスを直接使用することができます。

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "example-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

server.setRequestHandler(ListPromptsRequestSchema, async () => {
  return {
    prompts: [{
      name: "example-prompt",
      description: "An example prompt template",
      arguments: [{
        name: "arg1",
        description: "Example argument",
        required: true
      }]
    }]
  };
});

server.setRequestHandler(GetPromptRequestSchema, async (request) => {
  if (request.params.name !== "example-prompt") {
    throw new Error("Unknown prompt");
  }
  return {
    description: "Example prompt",
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: "Example prompt text"
      }
    }]
  };
});

const transport = new StdioServerTransport();
await server.connect(transport);