Create MCP Server

🚀 @m サーバーポート

このプロジェクトは、TypeScript と FastMCP を使用して構築されたサーバープロジェクトで、モデルコンテキストプロトコル (Model Context Protocol, MCP) を実装することを目的としています。このサーバーは、ツール、リソース、プロンプトなどの複数の機能モジュールをサポートし、CLI ツールを通じてテストやインスペクト操作を行うことができます。

🚀 クイックスタート

依存関係のインストール

npm install fastmcp @types/zod

サーバーの起動

npm run dev

✨ 主な機能

1. FastMCP を使用して MCP プロトコルを実装しています。
2. 標準の CLI ツール (fastmcp と fastmcp-inspect) をサポートし、テストやインスペクト操作を行うことができます。
3. 環境変数を通じてサーバーの動作をカスタマイズできる柔軟な設定オプションを提供しています。

📦 インストール

プロジェクトの初期化

npx @m/server init

または npm を使用する場合：

npm create @m/server

💻 使用例

基本的な使用法

# fastmcp を使用してテストサーバーを起動
npx fastmcp dev server.js

# fastmcp-inspect を使用してサーバーの状態を確認
npx fastmcp inspect server.ts

高度な使用法

// プロジェクトのルートディレクトリに server.ts ファイルを作成
import { FastMCP } from "fastmcp";

const server = new FastMCP();

// カスタムツールを追加
server.addTool({
  name: "hello_world",
  description: "A simple hello world tool",
  parameters: z.object({
    name: z.string().describe("Name to greet")
  }),
  execute: async (params) => {
    return `Hello, ${params.name}!`;
  }
});

// カスタムリソーステンプレートを追加
server.addResourceTemplate({
  uriTemplate: "example://{id}",
  name: "Example Resource",
  mimeType: "text/plain",
  arguments: [
    {
      name: "id",
      description: "Resource ID",
      required: true,
    },
  ],
  async load({ id }) {
    return {
      text: `This is an example resource with ID: ${id}`
    };
  }
});

// カスタムプロンプトを追加
server.addPrompt({
  name: "greeting",
  description: "A simple greeting prompt",
  arguments: [
    {
      name: "name",
      description: "Name to greet",
      required: true,
    },
  ],
  load: async ({ name }) => {
    return `Hello, ${name}! How can I help you today?`;
  }
});

// サーバーを起動
server.start();

環境変数の設定

# HTTP ポートを変更（デフォルトは 3001）
PORT=8080 npm run start

# バインドアドレスを変更（デフォルトは 0.0.0.0）
HOST=127.0.0.1 npm run start

📚 ドキュメント

• FastMCP 公式ドキュメント：FastMCP GitHub リポジトリ
• モデルコンテキストプロトコル (MCP)：MCP 公式ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。