Excel Master

🚀 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);

📚 ドキュメント

• MCP プロトコルドキュメント
• MCP 仕様
• サンプルサーバー

🔧 貢献ガイド

私たちはコミュニティからの貢献を歓迎します！もし何か問題を発見したり、提案がある場合は、以下の GitHub リポジトリをご覧ください。 GitHub リポジトリ