# jimeng-mcp-server

**Repository Path**: zivelin/jimeng-mcp-server

## Basic Information

- **Project Name**: jimeng-mcp-server
- **Description**: 接入即梦AI接口，实现MCP-Server端。  
数据传输采用`streamable-http`协议。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-09
- **Last Updated**: 2025-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 功能
接入即梦AI接口，实现文生图MCP-Server端。  
数据传输采用`streamable-http`协议。

## 开通即梦AI服务

1. 注册并登录[火山引擎](https://console.volcengine.com/)
2. 打开并申请开通[即梦AI服务](https://console.volcengine.com/ai/ability/detail/10)
3. 创建[API密钥](https://console.volcengine.com/iam/keymanage)


## 运行方式

> - 有些依赖库对python版本有要求，请按需升级，我的本地测试环境为`python3.12.11`
> - 启动端口、数据传输协议和mcp服务访问路径可在`jimeng_image_mcp_server.py`中修改 
> - `Trae CN`版本为`0.6.1`，`0.6.1`及以上版本支持`streamable-http`协议

1. 安装依赖库：`pip install -r requirements.txt`
2. 运行：`python jimeng_image_mcp_server.py`
3. 在`Trae CN`中配置`MCP Servers`：
  ```json
  {  
    "mcpServers": {
      "即梦文生图工具": {
        "url": "http://127.0.0.1:9000/jimeng_mcp",
        "headers": {
          "ak": "******",
          "sk": "******"
        }
      }
    }
  }
  ```
4. 在`Trae CN`中配置智能体工具，选中`即梦文生图工具`
5. 在AI侧栏的对话窗口中，输入提示词`使用即梦文生图工具生成一个Q版的可爱人物，并保存图片到本地`，等待图片生成并保存到本地，代表运行成功

## GitIngest玩一下

> [GitIngest介绍](https://www.oschina.net/p/cyclotruc-gitingest)

1. 安装`GitIngest`: `pip install gitingest`
2. 仓库信息提取: `gitingest -e "LICENSE" -e ".mcp" .`
3. 其中，`-e`是指剔除的文件，`.mcp`是我本地的`pyenv`环境
4. 执行结果如`digest.txt`文件所示

## 参考资料

1. [即梦AI-图像生成 接入文档](https://www.volcengine.com/docs/85621/1537648)
2. [火山引擎SDK for Python(volc-sdk-python)](https://github.com/volcengine/volc-sdk-pytho)
3. [FastMCP Quickstart](https://gofastmcp.com/getting-started/quickstart)