Typecast Api MCP Server Sample

🚀 類型轉換API - MCP服務器示例

本項目為Typecast API實現了MCP服務器，支持與MCP客戶端無縫集成。通過Model Context Protocol，提供了一種標準化的方式與Typecast API進行交互，讓開發者能夠更便捷地使用相關功能。

🚀 快速開始

1. Git克隆

git clone https://github.com/hyunseung/typecast-api-mcp-server-sample.git
cd typecast-api-mcp-server-sample

2. 依賴項安裝

該項目需要Python 3.10或更高版本，並使用uv進行包管理。

# 創建虛擬環境並安裝包
uv venv
uv pip install -e .

3. 環境變量設置

TYPECAST_API_HOST=https://api.typecast.ai
TYPECAST_API_KEY=<your-api-key>
TYPECAST_OUTPUT_DIR=<your-output-directory> # 默認：~/Downloads/typecast_output

4. 與Claude Desktop一起使用

您可以在claude_desktop_config.json中添加以下內容：

{
  "mcpServers": {
    "typecast-api-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/PATH/TO/YOUR/PROJECT",
        "run",
        "typecast-api-mcp-server"
      ],
      "env": {
        "TYPECAST_API_HOST": "https://api.typecast.ai",
        "TYPECAST_API_KEY": "YOUR_API_KEY",
        "TYPECAST_OUTPUT_DIR": "PATH/TO/YOUR/OUTPUT/DIR"
      }
    }
  }
}

請將/PATH/TO/YOUR/PROJECT替換為您實際項目的路徑。

5. 手動執行

您也可以手動運行服務器：

uv run python app/main.py

✨ 主要特性

該項目實現了Typecast API的Model 上下文協議服務器，允許MCP客戶端以標準化的方式與Typecast API交互。以下是部分功能的實現狀態：

📄 許可證

本項目採用MIT License。

貢獻

歡迎任何貢獻！請隨時提交拉取請求。