Stablemcp

🚀 穩定MCP項目文檔

穩定MCP（StableMCP）是一個開源工具，主要用於圖像生成和處理任務。它支持多種模型，並且提供簡單的API供用戶調用，能幫助用戶輕鬆完成圖像相關的操作。

🚀 快速開始

穩定MCP支持多種安裝方式，你可以根據自己的需求選擇合適的安裝方法。

📦 安裝指南

使用Docker安裝

若要使用Docker運行穩定MCP，可執行以下命令：

docker pull ghcr.io/mkm29/stablemcp:latest
docker run -p 8080:8080 ghcr.io/mkm29/stablemcp:latest

使用二進制文件安裝

在Linux系統上，可下載預編譯的二進制文件進行安裝：

wget https://github.com/mkm29/stablemcp/releases/download/v0.1.1/stablemcp-linux-amd64.tar.gz
tar zxvf stablemcp-linux-amd64.tar.gz
chmod +x stablemcp
./stablemcp serve

📚 詳細文檔

配置文件

穩定MCP可通過配置文件設置不同參數。默認配置文件位於config.yaml，內容如下：

server:
  port: 8080
  host: localhost

logging:
  level: info
  file: logs/stablemcp.log

models:
  sd-turbo:
    path: models/sd-turbo.ckpt
  sdxl:
    path: models/sdxl.ckpt

使用說明

生成圖像

通過以下命令可使用穩定MCP生成圖像：

curl -X POST http://localhost:8080/v1/generate \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a photo of a cat in space",
    "width": 512,
    "height": 512,
    "num_inference_steps": 50
  }'

MCP初始化請求

要初始化MCP服務，可發送以下請求：

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "initialize",
    "params": {}
  }'

開發指南

項目結構

穩定MCP的項目結構如下：

stablemcp/
├── cmd/          # 命令行工具入口
│   └── main.go
├── internal/     # 核心功能包
│   ├── version/    # 版本信息管理
│   │   └── version.go
│   └── config/     # 配置文件解析
│       └── config.go
├── models/        # 模型文件存儲位置
└── assets/         # 其他資源文件

初始化MCP服務

在代碼中初始化MCP服務的示例如下：

package main

import (
    "github.com/mkm29/stablemcp/internal/version"
)

func main() {
    // 獲取版本信息
    version := version.GetVersion()
    // 啟動服務
    startServer(version)
}

版本管理

穩定MCP採用語義化版本控制，當前版本為v0.1.1。

打標籤

要打新的標籤，可執行以下命令：

git tag -a v$(go run scripts/print_version.go) -m "New release"

持續集成和交付（CI/CD）

穩定MCP的持續集成流程如下：

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Set up Go
        uses: actions/setup-go@v1
          go-version: 1.x.x
      - name: Run tests
        run: make test

貢獻指南

提交代碼

要提交代碼到倉庫，可執行以下步驟：

git clone https://github.com/mkm29/stablemcp.git
cd stablemcp
git checkout main
# 添加文件
git add .
# 提交更改
git commit -m "Add new feature"
git push origin main

開發環境搭建

要為穩定MCP創建一個開發環境，可按以下步驟操作：

git clone https://github.com/mkm29/stablemcp.git
cd stablemcp
make dev_setup
# 啟動服務
./stablemcp serve --dev

📄 許可證

穩定MCP遵循MIT許可證，完整的許可證內容如下：

 MIT License

 Copyright (c) 2023 Your Name

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:

 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.

 THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

貢獻者

• 作者：Your Name your.email@example.com
• 維護人員：Maintainer Name maintain.email@example.com

聯繫方式

若有關於穩定MCP的任何問題，可通過以下方式聯繫：

• 郵箱：contact@stablemcp.org
• GitHub：https://github.com/mkm29/stablemcp