类型转换API-MCP服务器示例

为Typecast API实现MCP（模型上下文协议）服务器，支持无缝集成到MCP客户端。该项目提供了一种标准化方式，通过Model Context Protocol与Typecast API交互。

项目概述

本项目实现了Typecast API的模型上下文协议服务器端，允许MCP客户端以统一的方式与Typecast API进行互动。

功能实现状态

安装设置

使用Git克隆仓库

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

依赖项

该项目需要Python 3.10或更高版本，并使用uv进行包管理。

包的安装

# 创建虚拟环境并安装依赖项
uv venv
uv pip install -e .

环境变量设置

设置以下环境变量：

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

在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替换为您实际项目所在的路径。

手动运行

也可以手动运行服务器：

uv run python app/main.py

贡献

欢迎任何形式的贡献！请随时提交Pull Request。

许可证

MIT License