出典: https://github.com/microsoft/mcp-for-beginners フォーク元リポジトリ: https://github.com/microsoft/mcp-for-beginners (Microsoft) ライセンス: MIT License

MCPの始め方¶

Model Context Protocol (MCP) の最初のステップへようこそ！MCPが初めての方も、理解を深めたい方も、このガイドでは基本的なセットアップと開発プロセスを説明します。MCPがAIモデルとアプリケーション間のシームレスな統合をどのように実現するかを学び、MCPを活用したソリューションを構築・テストするための環境を迅速に準備する方法を紹介します。

TLDR; AIアプリを構築する際、LLM（大規模言語モデル）にツールやリソースを追加して、LLMの知識を拡張できることはご存知でしょう。しかし、それらのツールやリソースをサーバーに配置すると、LLMの有無に関わらず、アプリやサーバーの機能を任意のクライアントが利用できるようになります。

概要¶

このレッスンでは、MCP環境のセットアップと最初のMCPアプリケーションの構築に関する実践的なガイダンスを提供します。必要なツールやフレームワークのセットアップ方法、基本的なMCPサーバーの構築、ホストアプリケーションの作成、実装のテスト方法を学びます。

Model Context Protocol (MCP) は、アプリケーションがLLMにコンテキストを提供する方法を標準化するオープンプロトコルです。MCPは、AIアプリケーションのUSB-Cポートのようなもので、AIモデルをさまざまなデータソースやツールに接続するための標準化された方法を提供します。

学習目標¶

このレッスンの終わりまでに、以下ができるようになります：

C#、Java、Python、TypeScript、JavaScriptでMCPの開発環境をセットアップする
カスタム機能（リソース、プロンプト、ツール）を備えた基本的なMCPサーバーを構築・デプロイする
MCPサーバーに接続するホストアプリケーションを作成する
MCPの実装をテスト・デバッグする

MCP環境のセットアップ¶

MCPを使い始める前に、開発環境を準備し、基本的なワークフローを理解することが重要です。このセクションでは、MCPをスムーズに始めるための初期設定手順を説明します。

前提条件¶

MCP開発に取り組む前に、以下を確認してください：

開発環境：選択した言語（C#、Java、Python、TypeScript、JavaScript）に対応した環境
IDE/エディタ：Visual Studio、Visual Studio Code、IntelliJ、Eclipse、PyCharm、またはその他のモダンなコードエディタ
パッケージマネージャ：NuGet、Maven/Gradle、pip、npm/yarn
APIキー：ホストアプリケーションで使用する予定のAIサービス用

基本的なMCPサーバー構造¶

MCPサーバーは通常以下を含みます：

サーバー設定：ポート、認証、その他の設定
リソース：LLMに提供されるデータとコンテキスト
ツール：モデルが呼び出せる機能
プロンプト：テキスト生成や構造化のテンプレート

以下はTypeScriptの簡略化された例です：

import { Server, Tool, Resource } from "@modelcontextprotocol/typescript-server-sdk";

// Create a new MCP server
const server = new Server({
  port: 3000,
  name: "Example MCP Server",
  version: "1.0.0"
});

// Register a tool
server.registerTool({
  name: "calculator",
  description: "Performs basic calculations",
  parameters: {
    expression: {
      type: "string",
      description: "The math expression to evaluate"
    }
  },
  handler: async (params) => {
    const result = eval(params.expression);
    return { result };
  }
});

// Start the server
server.start();

上記のコードでは以下を行っています：

MCP TypeScript SDKから必要なクラスをインポート
新しいMCPサーバーインスタンスを作成・設定
ハンドラ関数を持つカスタムツール（calculator）を登録
サーバーを起動してMCPリクエストを受け付ける

テストとデバッグ¶

MCPサーバーをテストする前に、利用可能なツールとデバッグのベストプラクティスを理解することが重要です。効果的なテストは、サーバーが期待通りに動作することを確認し、問題を迅速に特定・解決するのに役立ちます。このセクションでは、MCP実装を検証するための推奨アプローチを説明します。

MCPはサーバーのテストとデバッグを支援するツールを提供しています：

インスペクターツール：このグラフィカルインターフェースを使用して、サーバーに接続し、ツール、プロンプト、リソースをテストできます。
curl：コマンドラインツールのcurlやHTTPコマンドを作成・実行できる他のクライアントを使用してサーバーに接続することも可能です。

MCPインスペクターの使用¶

MCP Inspectorは、以下を支援する視覚的なテストツールです：

サーバー機能の発見：利用可能なリソース、ツール、プロンプトを自動検出
ツール実行のテスト：さまざまなパラメータを試し、リアルタイムで応答を確認
サーバーメタデータの表示：サーバー情報、スキーマ、設定を調査

# ex TypeScript, installing and running MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js

上記のコマンドを実行すると、MCP InspectorがブラウザでローカルWebインターフェースを起動します。登録済みのMCPサーバー、利用可能なツール、リソース、プロンプトを表示するダッシュボードが表示されます。このインターフェースを使用して、ツールの実行をインタラクティブにテストし、サーバーメタデータを調査し、リアルタイムの応答を確認できます。これにより、MCPサーバーの実装を検証・デバッグしやすくなります。

以下はそのスクリーンショットの例です：

よくあるセットアップの問題と解決策¶

問題	解決策
接続拒否	サーバーが起動しているか、ポートが正しいか確認
ツール実行エラー	パラメータの検証とエラーハンドリングを確認
認証失敗	APIキーと権限を確認
スキーマ検証エラー	パラメータが定義されたスキーマに一致しているか確認
サーバーが起動しない	ポート競合や依存関係の欠如を確認
CORSエラー	クロスオリジンリクエスト用の適切なCORSヘッダーを設定
認証問題	トークンの有効性と権限を確認

ローカル開発¶

ローカルでの開発とテストでは、MCPサーバーを直接マシン上で実行できます：

サーバープロセスの開始：MCPサーバーアプリケーションを実行
ネットワーク設定：サーバーが期待されるポートでアクセス可能であることを確認
クライアントの接続：http://localhost:3000のようなローカル接続URLを使用

# Example: Running a TypeScript MCP server locally
npm run start
# Server running at http://localhost:3000

最初のMCPサーバーの構築¶

以前のレッスンでコアコンセプトを学びましたが、ここではその知識を活用します。

サーバーができること¶

コードを書く前に、サーバーができることを思い出してみましょう：

MCPサーバーは例えば以下を行うことができます：

ローカルファイルやデータベースへのアクセス
リモートAPIへの接続
計算の実行
他のツールやサービスとの統合
ユーザーインターフェースの提供

素晴らしいですね。では、コードを書き始めましょう。

演習：サーバーの作成¶

サーバーを作成するには、以下の手順を実行します：

MCP SDKをインストールする
プロジェクトを作成し、プロジェクト構造を設定する
サーバーコードを書く
サーバーをテストする

-1- プロジェクトの作成¶

TypeScript¶

# Create project directory and initialize npm project
mkdir calculator-server
cd calculator-server
npm init -y

Python¶

# Create project dir
mkdir calculator-server
cd calculator-server
# Open the folder in Visual Studio Code - Skip this if you are using a different IDE
code .

.NET¶

dotnet new console -n McpCalculatorServer
cd McpCalculatorServer

Java¶

JavaではSpring Bootプロジェクトを作成します：

curl https://start.spring.io/starter.zip \
  -d dependencies=web \
  -d javaVersion=21 \
  -d type=maven-project \
  -d groupId=com.example \
  -d artifactId=calculator-server \
  -d name=McpServer \
  -d packageName=com.microsoft.mcp.sample.server \
  -o calculator-server.zip

Zipファイルを解凍します：

unzip calculator-server.zip -d calculator-server
cd calculator-server
# optional remove the unused test
rm -rf src/test/java

以下の完全な設定をpom.xmlファイルに追加します：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!-- Spring Boot parent for dependency management -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.5.0</version>
        <relativePath />
    </parent>

    <!-- Project coordinates -->
    <groupId>com.example</groupId>
    <artifactId>calculator-server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>Calculator Server</name>
    <description>Basic calculator MCP service for beginners</description>

    <!-- Properties -->
    <properties>
        <java.version>21</java.version>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
    </properties>

    <!-- Spring AI BOM for version management -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.ai</groupId>
                <artifactId>spring-ai-bom</artifactId>
                <version>1.0.0-SNAPSHOT</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <!-- Dependencies -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-test</artifactId>
         <scope>test</scope>
      </dependency>
    </dependencies>

    <!-- Build configuration -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <release>21</release>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <!-- Repositories for Spring AI snapshots -->
    <repositories>
        <repository>
            <id>spring-milestones</id>
            <name>Spring Milestones</name>
            <url>https://repo.spring.io/milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
        <repository>
            <id>spring-snapshots</id>
            <name>Spring Snapshots</name>
            <url>https://repo.spring.io/snapshot</url>
            <releases>
                <enabled>false</enabled>
            </releases>
        </repository>
    </repositories>
</project>

-2- 依存関係の追加¶

プロジェクトを作成したら、次に依存関係を追加します：

TypeScript¶

# If not already installed, install TypeScript globally
npm install typescript -g

# Install the MCP SDK and Zod for schema validation
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript

Python¶

# Create a virtual env and install dependencies
python -m venv venv
venv\Scriptsctivate
pip install "mcp[cli]"

Java¶

cd calculator-server
./mvnw clean install -DskipTests

-3- プロジェクトファイルの作成¶

TypeScript¶

package.jsonファイルを開き、以下の内容に置き換えてサーバーをビルド・実行できるようにします：

{
  "name": "calculator-server",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "tsc && node ./build/index.js",
    "build": "tsc && node ./build/index.js"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": "A simple calculator server using Model Context Protocol",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.16.0",
    "zod": "^3.25.76"
  },
  "devDependencies": {
    "@types/node": "^24.0.14",
    "typescript": "^5.8.3"
  }
}

tsconfig.jsonを作成し、以下の内容を追加します：

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

ソースコード用のディレクトリを作成します：

mkdir src
touch src/index.ts

Python¶

server.pyファイルを作成します：

touch server.py

.NET¶

必要なNuGetパッケージをインストールします：

dotnet add package ModelContextProtocol --prerelease
dotnet add package Microsoft.Extensions.Hosting

Java¶

Java Spring Bootプロジェクトでは、プロジェクト構造が自動的に作成されます。

-4- サーバーコードの作成¶

TypeScript¶

index.tsファイルを作成し、以下のコードを追加します：

import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// Create an MCP server
const server = new McpServer({
  name: "Calculator MCP Server",
  version: "1.0.0"
});

これでサーバーが作成されましたが、まだあまり機能していません。これを改善しましょう。

Python¶

# server.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")

.NET¶

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using ModelContextProtocol.Server;
using System.ComponentModel;

var builder = Host.CreateApplicationBuilder(args);
builder.Logging.AddConsole(consoleLogOptions =>
{
    // Configure all logs to go to stderr
    consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
});

builder.Services
    .AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly();
await builder.Build().RunAsync();

// add features

Java¶

Javaでは、コアサーバーコンポーネントを作成します。まず、メインアプリケーションクラスを修正します：

src/main/java/com/microsoft/mcp/sample/server/McpServerApplication.java：

package com.microsoft.mcp.sample.server;

import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import com.microsoft.mcp.sample.server.service.CalculatorService;

@SpringBootApplication
public class McpServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(McpServerApplication.class, args);
    }

    @Bean
    public ToolCallbackProvider calculatorTools(CalculatorService calculator) {
        return MethodToolCallbackProvider.builder().toolObjects(calculator).build();
    }
}

計算サービスを作成します：src/main/java/com/microsoft/mcp/sample/server/service/CalculatorService.java：

package com.microsoft.mcp.sample.server.service;

import org.springframework.ai.tool.annotation.Tool;
import org.springframework.stereotype.Service;

/**
 * Service for basic calculator operations.
 * This service provides simple calculator functionality through MCP.
 */
@Service
public class CalculatorService {

    /**
     * Add two numbers
     * @param a The first number
     * @param b The second number
     * @return The sum of the two numbers
     */
    @Tool(description = "Add two numbers together")
    public String add(double a, double b) {
        double result = a + b;
        return formatResult(a, "+", b, result);
    }

    /**
     * Subtract one number from another
     * @param a The number to subtract from
     * @param b The number to subtract
     * @return The result of the subtraction
     */
    @Tool(description = "Subtract the second number from the first number")
    public String subtract(double a, double b) {
        double result = a - b;
        return formatResult(a, "-", b, result);
    }

    /**
     * Multiply two numbers
     * @param a The first number
     * @param b The second number
     * @return The product of the two numbers
     */
    @Tool(description = "Multiply two numbers together")
    public String multiply(double a, double b) {
        double result = a * b;
        return formatResult(a, "*", b, result);
    }

    /**
     * Divide one number by another
     * @param a The numerator
     * @param b The denominator
     * @return The result of the division
     */
    @Tool(description = "Divide the first number by the second number")
    public String divide(double a, double b) {
        if (b == 0) {
            return "Error: Cannot divide by zero";
        }
        double result = a / b;
        return formatResult(a, "/", b, result);
    }

    /**
     * Calculate the power of a number
     * @param base The base number
     * @param exponent The exponent
     * @return The result of raising the base to the exponent
     */
    @Tool(description = "Calculate the power of a number (base raised to an exponent)")
    public String power(double base, double exponent) {
        double result = Math.pow(base, exponent);
        return formatResult(base, "^", exponent, result);
    }

    /**
     * Calculate the square root of a number
     * @param number The number to find the square root of
     * @return The square root of the number
     */
    @Tool(description = "Calculate the square root of a number")
    public String squareRoot(double number) {
        if (number < 0) {
            return "Error: Cannot calculate square root of a negative number";
        }
        double result = Math.sqrt(number);
        return String.format("√%.2f = %.2f", number, result);
    }

    /**
     * Calculate the modulus (remainder) of division
     * @param a The dividend
     * @param b The divisor
     * @return The remainder of the division
     */
    @Tool(description = "Calculate the remainder when one number is divided by another")
    public String modulus(double a, double b) {
        if (b == 0) {
            return "Error: Cannot divide by zero";
        }
        double result = a % b;
        return formatResult(a, "%", b, result);
    }

    /**
     * Calculate the absolute value of a number
     * @param number The number to find the absolute value of
     * @return The absolute value of the number
     */
    @Tool(description = "Calculate the absolute value of a number")
    public String absolute(double number) {
        double result = Math.abs(number);
        return String.format("|%.2f| = %.2f", number, result);
    }

    /**
     * Get help about available calculator operations
     * @return Information about available operations
     */
    @Tool(description = "Get help about available calculator operations")
    public String help() {
        return "Basic Calculator MCP Service

" +
               "Available operations:
" +
               "1. add(a, b) - Adds two numbers
" +
               "2. subtract(a, b) - Subtracts the second number from the first
" +
               "3. multiply(a, b) - Multiplies two numbers
" +
               "4. divide(a, b) - Divides the first number by the second
" +
               "5. power(base, exponent) - Raises a number to a power
" +
               "6. squareRoot(number) - Calculates the square root
" + 
               "7. modulus(a, b) - Calculates the remainder of division
" +
               "8. absolute(number) - Calculates the absolute value

" +
               "Example usage: add(5, 3) will return 5 + 3 = 8";
    }

    /**
     * Format the result of a calculation
     */
    private String formatResult(double a, String operator, double b, double result) {
        return String.format("%.2f %s %.2f = %.2f", a, operator, b, result);
    }
}

本番環境向けのオプションコンポーネント：

スタートアップ設定を作成します：src/main/java/com/microsoft/mcp/sample/server/config/StartupConfig.java：

package com.microsoft.mcp.sample.server.config;

import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class StartupConfig {

    @Bean
    public CommandLineRunner startupInfo() {
        return args -> {
            System.out.println("
" + "=".repeat(60));
            System.out.println("Calculator MCP Server is starting...");
            System.out.println("SSE endpoint: http://localhost:8080/sse");
            System.out.println("Health check: http://localhost:8080/actuator/health");
            System.out.println("=".repeat(60) + "
");
        };
    }
}

ヘルスコントローラーを作成します：src/main/java/com/microsoft/mcp/sample/server/controller/HealthController.java：

package com.microsoft.mcp.sample.server.controller;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.time.LocalDateTime;
import java.util.HashMap;
import java.util.Map;

@RestController
public class HealthController {

    @GetMapping("/health")
    public ResponseEntity<Map<String, Object>> healthCheck() {
        Map<String, Object> response = new HashMap<>();
        response.put("status", "UP");
        response.put("timestamp", LocalDateTime.now().toString());
        response.put("service", "Calculator MCP Server");
        return ResponseEntity.ok(response);
    }
}

例外ハンドラーを作成します：src/main/java/com/microsoft/mcp/sample/server/exception/GlobalExceptionHandler.java：

package com.microsoft.mcp.sample.server.exception;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<ErrorResponse> handleIllegalArgumentException(IllegalArgumentException ex) {
        ErrorResponse error = new ErrorResponse(
            "Invalid_Input", 
            "Invalid input parameter: " + ex.getMessage());
        return new ResponseEntity<>(error, HttpStatus.BAD_REQUEST);
    }

    public static class ErrorResponse {
        private String code;
        private String message;

        public ErrorResponse(String code, String message) {
            this.code = code;
            this.message = message;
        }

        // Getters
        public String getCode() { return code; }
        public String getMessage() { return message; }
    }
}

カスタムバナーを作成します：src/main/resources/banner.txt：

_____      _            _       _             
 / ____|    | |          | |     | |            
| |     __ _| | ___ _   _| | __ _| |_ ___  _ __ 
| |    / _` | |/ __| | | | |/ _` | __/ _ \| '__|
| |___| (_| | | (__| |_| | | (_| | || (_) | |   
 \_____\__,_|_|\___|\__,_|_|\__,_|\__\___/|_|   

Calculator MCP Server v1.0
Spring Boot MCP Application

-5- ツールとリソースの追加¶

以下のコードを追加してツールとリソースを追加します：

TypeScript¶

server.tool(
  "add",
  { a: z.number(), b: z.number() },
  async ({ a, b }) => ({
    content: [{ type: "text", text: String(a + b) }]
  })
);

server.resource(
  "greeting",
  new ResourceTemplate("greeting://{name}", { list: undefined }),
  async (uri, { name }) => ({
    contents: [{
      uri: uri.href,
      text: `Hello, ${name}!`
    }]
  })
);

ツールはパラメータaとbを受け取り、以下の形式の応答を生成します：

{
  contents: [{
    type: "text", content: "some content"
  }]
}

リソースは文字列"greeting"を通じてアクセスされ、パラメータnameを受け取り、ツールと似た応答を生成します：

{
  uri: "<href>",
  text: "a text"
}

Python¶

# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

上記のコードでは以下を行っています：

パラメータaとp（どちらも整数）を受け取るツールaddを定義
nameというパラメータを受け取るリソースgreetingを作成

.NET¶

Program.csファイルに以下を追加します：

[McpServerToolType]
public static class CalculatorTool
{
    [McpServerTool, Description("Adds two numbers")]
    public static string Add(int a, int b) => $"Sum {a + b}";
}

Java¶

ツールは前のステップで既に作成されています。

-6- 最終コード¶

サーバーを起動できるようにするための最後のコードを追加します：

TypeScript¶

// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
await server.connect(transport);

以下が完全なコードです：

// index.ts
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

// Create an MCP server
const server = new McpServer({
  name: "Calculator MCP Server",
  version: "1.0.0"
});

// Add an addition tool
server.tool(
  "add",
  { a: z.number(), b: z.number() },
  async ({ a, b }) => ({
    content: [{ type: "text", text: String(a + b) }]
  })
);

// Add a dynamic greeting resource
server.resource(
  "greeting",
  new ResourceTemplate("greeting://{name}", { list: undefined }),
  async (uri, { name }) => ({
    contents: [{
      uri: uri.href,
      text: `Hello, ${name}!`
    }]
  })
);

// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
server.connect(transport);

Python¶

# server.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")


# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

# Main execution block - this is required to run the server
if __name__ == "__main__":
    mcp.run()

.NET¶

Program.csファイルを以下の内容で作成します：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using ModelContextProtocol.Server;
using System.ComponentModel;

var builder = Host.CreateApplicationBuilder(args);
builder.Logging.AddConsole(consoleLogOptions =>
{
    // Configure all logs to go to stderr
    consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
});

builder.Services
    .AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly();
await builder.Build().RunAsync();

[McpServerToolType]
public static class CalculatorTool
{
    [McpServerTool, Description("Adds two numbers")]
    public static string Add(int a, int b) => $"Sum {a + b}";
}

Java¶

メインアプリケーションクラスの完全な内容は以下のようになります：

// McpServerApplication.java
package com.microsoft.mcp.sample.server;

import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import com.microsoft.mcp.sample.server.service.CalculatorService;

@SpringBootApplication
public class McpServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(McpServerApplication.class, args);
    }

    @Bean
    public ToolCallbackProvider calculatorTools(CalculatorService calculator) {
        return MethodToolCallbackProvider.builder().toolObjects(calculator).build();
    }
}

-7- サーバーのテスト¶

以下のコマンドでサーバーを起動します：

TypeScript¶

npm run build

Python¶

mcp run server.py

MCP Inspectorを使用するには、mcp dev server.pyを使用してください。このコマンドはInspectorを自動的に起動し、必要なプロキシセッショントークンを提供します。mcp run server.pyを使用する場合は、Inspectorを手動で起動し、接続を設定する必要があります。

.NET¶

プロジェクトディレクトリにいることを確認してください：

cd McpCalculatorServer
dotnet run

Java¶

./mvnw clean install -DskipTests
java -jar target/calculator-server-0.0.1-SNAPSHOT.jar

-8- インスペクターを使用して実行¶

インスペクターはサーバーを起動し、サーバーが動作するかどうかをテストするための便利なツールです。以下の手順で起動します：

[!NOTE] 実行コマンドは、使用しているランタイムに応じて異なる場合があります。

TypeScript¶

npx @modelcontextprotocol/inspector node build/index.js

または、package.jsonに以下を追加します："inspector": "npx @modelcontextprotocol/inspector node build/index.js" そしてnpm run inspectを実行します。

PythonはNode.jsツールであるインスペクターをラップしています。このツールを以下のように呼び出すことができます：

mcp dev server.py

ただし、ツールのすべてのメソッドを実装しているわけではないため、以下のようにNode.jsツールを直接実行することを推奨します：

npx @modelcontextprotocol/inspector mcp run server.py

ツールやIDEでスクリプトを実行するコマンドと引数を設定できる場合は、pythonをCommandフィールドに、server.pyをArgumentsとして設定してください。これによりスクリプトが正しく実行されます。

.NET¶

プロジェクトディレクトリにいることを確認してください：

cd McpCalculatorServer
npx @modelcontextprotocol/inspector dotnet run

Java¶

計算サーバーが起動していることを確認してください。次にインスペクターを実行します：

npx @modelcontextprotocol/inspector

インスペクターのWebインターフェースで：

"SSE"をトランスポートタイプとして選択
URLをhttp://localhost:8080/sseに設定
"Connect"をクリック

Connect

これでサーバーに接続されました Javaサーバーのテストセクションはこれで完了です

次のセクションではサーバーとの対話について説明します。

以下のユーザーインターフェースが表示されるはずです：

Connect

"Connect"ボタンを選択してサーバーに接続します。サーバーに接続すると、以下の画面が表示されるはずです：

Connected

"Tools"を選択し、"listTools"を選択します。"Add"が表示されるはずです。"Add"を選択し、パラメータ値を入力します。

以下の応答が表示されるはずです。つまり、"add"ツールの結果です：

Result of running add

おめでとうございます！最初のサーバーを作成して実行することができました！

公式SDK¶

MCPは複数の言語向けに公式SDKを提供しています：

C# SDK - Microsoftとの共同で管理
Java SDK - Spring AIとの共同で管理
TypeScript SDK - 公式TypeScript実装
Python SDK - 公式Python実装
Kotlin SDK - 公式のKotlin実装
Swift SDK - Loopwork AIとの共同で管理
Rust SDK - 公式のRust実装

主なポイント¶

MCP開発環境のセットアップは、言語別のSDKを使用することで簡単に行えます
MCPサーバーの構築では、明確なスキーマを持つツールを作成し登録する必要があります
信頼性の高いMCP実装には、テストとデバッグが不可欠です

サンプル¶

課題¶

選択したツールを使用して簡単なMCPサーバーを作成してください:

好きな言語（.NET、Java、Python、JavaScript）でツールを実装する
入力パラメータと戻り値を定義する
インスペクターツールを実行して、サーバーが意図通りに動作することを確認する
様々な入力で実装をテストする

解答¶

解答

追加リソース¶

次に進む¶

次: MCPクライアントの使い方

免責事項:
この文書は、AI翻訳サービス Co-op Translator を使用して翻訳されています。正確性を追求しておりますが、自動翻訳には誤りや不正確な部分が含まれる可能性があることをご承知ください。元の言語で記載された文書が正式な情報源とみなされるべきです。重要な情報については、専門の人間による翻訳を推奨します。この翻訳の使用に起因する誤解や誤解釈について、当社は責任を負いません。