Ideogram Images

🚀 🎨 Ideogram MCP 服務器

Ideogram MCP 服務器基於 Model Context Protocol (MCP)，藉助 Ideogram API 實現圖像生成功能，為用戶提供便捷的圖像創作體驗。

🚀 快速開始

環境準備

請確保你的環境已經安裝好 npm 和 git。

安裝與配置

1. 安裝依賴：在項目根目錄下執行以下命令，安裝所需的依賴項。

npm install

2. 設置環境變量：創建一個 .env 文件，並添加你的 Ideogram API 密鑰。

IDEOGRAM_API_KEY=your_api_key_here

3. 項目構建：執行以下命令完成項目構建。

npm run build

4. （可選）全局安裝：若你需要在全局使用該工具，可執行以下命令。

npm link

✨ 主要特性

• 圖像生成：根據用戶輸入的提示信息生成高質量的圖像。
• 參數自定義：支持多種參數自定義，包括寬高比、模型選擇、魔法提示、風格類型、負面提示以及生成圖像數量等。

📦 安裝指南

依賴安裝

npm install

環境變量配置

創建 .env 文件並添加如下內容：

IDEOGRAM_API_KEY=your_api_key_here

項目構建

npm run build

全局安裝（可選）

npm link

💻 使用示例

MCP 工具 - generate_image

generate_image 是用於生成圖像的工具，以下是其使用說明：

必需參數

• prompt：生成圖像所使用的提示信息。

可選參數

• aspect_ratio：圖像的寬高比，可選值有 ASPECT_1_1、ASPECT_4_3、ASPECT_3_4、ASPECT_16_9、ASPECT_9_16。
• model：使用的模型，可選值有 V_1、V_1_TURBO、V_2、V_2_TURBO。
• magic_prompt_option：魔法提示設置，可選值有 AUTO、ON、OFF。
• style_type：生成風格。
• negative_prompt：要排除的內容描述。
• num_images：要生成的圖像數量，範圍為 1 - 8。

代碼示例

const result = await use_mcp_tool({
  server_name: "ideagram-mcp-server",
  tool_name: "generate_image",
  parameters: {
    prompt: "a beautiful sunset over the mountains"
  }
});

📚 詳細文檔

開發指南

克隆倉庫

git clone https://github.com/sunwood-ai-labs/ideagram-mcp-server.git
cd ideagram-mcp-server

安裝依賴

npm install

啟動開發服務器

npm run dev

項目構建

npm run build

運行測試

npm test

貢獻指南

1. 創建分支：Fork 倉庫並在本地克隆後，創建一個新的功能分支。

git checkout -b feature/new-feature

2. 提交更改：完成代碼修改後，將更改提交併推送到遠程倉庫。

git add .
git commit -m "添加新功能"
git push origin feature/new-feature

3. 創建 Pull Request：在 GitHub 上創建一個 Pull Request 到主分支。

🔗 相關鏈接

項目倉庫