Create MCP Server

🚀 @m 服務器端口

這是一個使用 TypeScript 和 FastMCP 搭建的服務器項目，旨在實現模型上下文協議 (Model Context Protocol, MCP)。該服務器支持多種功能模塊，可通過 CLI 工具進行測試和 inspect 操作。

🚀 快速開始

安裝依賴

npm install fastmcp @types/zod

啟動服務器

npm run dev

✨ 主要特性

1. 使用 FastMCP 實現 MCP 協議。
2. 支持標準的 CLI 工具 (fastmcp 和 fastmcp-inspect) 進行測試和 inspect 操作。
3. 提供靈活的配置選項，支持通過環境變量自定義服務器行為。

📦 安裝指南

初始化項目

npx @m/server init

或者使用 npm：

npm create @m/server

💻 使用示例

基礎用法

# 使用 fastmcp 啟動測試服務器
npx fastmcp dev server.js

# 使用 fastmcp-inspect 檢查服務器狀態
npx fastmcp inspect 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

📚 詳細文檔

項目內容

• 基礎設置：實現了 MCP 協議的基本功能，包括工具、資源和提示的註冊與管理。
• 工具模塊：提供了自定義工具的接口，可擴展實現多種服務器功能。
• 資源模板：支持基於 URI 模板的資源加載，便於動態生成內容。
• 提示系統：實現了交互式提示功能，可與客戶端進行自然語言對話。

文檔資料

• FastMCP 官方文檔：FastMCP GitHub 倉庫
• 模型上下文協議 (MCP)：MCP 官方文檔

📄 許可證

本項目在 MIT 許可證下發布 - 有關詳細信息，請參閱 LICENSE 文件。