MCP Templateio

🚀 MCP TemplateIO - 圖像生成工具

MCP TemplateIO 是一個基於 mcp-framework 構建的 Model Context Protocol (MCP) 服務器，為用戶提供了基於 Templated.io 的圖像生成工具，助力用戶輕鬆實現圖像生成需求。

🚀 快速開始

# 安裝依賴項
npm install

# 構建項目
npm run build

✨ 主要特性

• 提供基於 Templated.io 的圖像生成工具，可根據文字和圖片 URL 生成圖像。
• 為構建具有自定義工具的 MCP 服務器提供起點，包含示例工具及相關開發說明。
• 支持使用 CLI 添加更多工具，方便擴展功能。

📦 安裝指南

安裝依賴

npm install

構建項目

npm run build

💻 使用示例

基礎用法

# 添加一個新的工具
mcp add tool my-tool

# 自定義工具的示例
mcp add tool custom-image-generator

高級用法

# 全局安裝
npm install -g mcp-templateio

# 命令行工具使用
mcp [command]

支持的命令：

• new <project-name>: 創建新項目。
• run: 運行服務器。

📚 詳細文檔

項目結構

mcp-templateio/
├── src/
│   ├── tools/        # MCP 工具
│   │   ├── ExampleTool.ts
│   │   └── TemplatedImageTool.ts # 圖像生成工具
│   └── index.ts      # 服務器入口文件
├── package.json
└── tsconfig.json

可用工具

基於模板的圖像生成器

此工具使用 Templated.io API 根據給定的文字和圖片 URL 生成圖像。

輸入參數：

• templateId: 使用的 Templated.io 模板 ID
• photoBgImageUrl: 放置在“photo-bg”層中的圖片 URL。
• bgYellowImageUrl: 放置在“bg-yellow”層中的圖片 URL。
• buildText: 用於“構建”文字層的文字內容。

工具開發

自定義工具結構示例：

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "描述您的工具的功能";

  schema = {
    message: {
      type: z.string(),
      description: "此輸入參數的描述",
    },
  };

  async execute(input: MyToolInput) {
    // 您的工具邏輯在此處
    return `處理結果：${input.message}`;
  }
}

export default MyTool;

添加組件

該項目附帶了示例工具在 src/tools/ExampleTool.ts 和 TemplatedImageTool.ts 中。您可以使用 CLI 添加更多工具：

# 添加一個新的工具
mcp add tool my-tool

# 自定義工具的示例
mcp add tool custom-image-generator

發佈到 npm

發佈前配置

1. 編輯 package.json
   • 確保 name、version 和 description 字段正確。
   • 添加所有依賴項。
2. 創建 README.md
   • 簡要描述您的工具及其功能。
3. 配置許可證
   • 在 package.json 中指定許可證信息，例如：

     "license": "MIT"
     

4. 設置構建腳本
   • 在 package.json 的 scripts 部分添加構建、測試和清理命令。
5. 註冊到 npm
   • 使用以下命令註冊您的包：

     npm register --user yourusername --email your.email@example.com
     

發佈

npm publish

與 Claude Desktop 一起使用

全局安裝

npm install -g mcp-templateio

命令行工具

mcp [command]

支持的命令：

• new <project-name>: 創建新項目。
• run: 運行服務器。

配置環境變量

將以下內容添加到您的 .env 文件：

NODE_ENV=development
PORT=3000

在 Windows 上，編輯 %USERPROFILE%\_config\js\default.json：

{
  "extends": ["~/_config/js/browserslist"]
}

在 macOS 或 Linux 上，創建 ~/.config/browserslist.json：

{
  "browserslist": {
    "production": [],
    "development": [
      ">0.2%",
      "not dead",
      "not op_mini all"
    ]
  }
}

相關鏈接

• MCP Framework Github
• MCP Framework 文檔