ANSYS Fluent MCP 服务器

一个基于模型上下文协议（MCP）的服务器，帮助AI助手高效地导航ANSYS Fluent在线文档。

特性

• 智能URL导航器 - 立即找到相关的ANSYS帮助文档URL
• 35+主题路径 - 预映射到常见Fluent主题的路径
• 始终最新 - 指向官方ANSYS文档
• 零维护 - 无需更新静态内容
• 轻量级 - 快速生成URL，无重型索引

快速开始

先决条件

• Python 3.10或更高版本
• uv 包管理器

安装

选择下面的MCP客户端以获取设置说明：

<details> <summary><b>Claude Code</b> (命令行界面)</summary>

claude mcp add fluent -- uvx fluent-mcp-server

验证：

claude mcp list
claude mcp info fluent

</details> <details> <summary><b>Claude Desktop</b></summary>

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fluent": {
      "command": "uvx",
      "args": ["fluent-mcp-server"]
    }
  }
}

保存后完全重启Claude Desktop。

</details> <details> <summary><b>Cursor</b></summary>

前往 Cursor 设置 → MCP → 添加新MCP服务器：

• 名称: fluent
• 命令: uvx fluent-mcp-server

或者编辑配置文件：

macOS: ~/Library/Application Support/Cursor/mcp_config.json Windows: %APPDATA%\Cursor\mcp_config.json Linux: ~/.config/Cursor/mcp_config.json

{
  "mcpServers": {
    "fluent": {
      "command": "uvx",
      "args": ["fluent-mcp-server"]
    }
  }
}

</details> <details> <summary><b>VS Code</b> (GitHub Copilot)</summary>

命令行：

code --add-mcp '{"name":"fluent","command":"uvx","args":["fluent-mcp-server"]}'

或者添加到VS Code设置：

{
  "github.copilot.chat.mcp.servers": {
    "fluent": {
      "command": "uvx",
      "args": ["fluent-mcp-server"]
    }
  }
}

</details> <details> <summary><b>Cline</b> (VS Code扩展)</summary>

安装Cline扩展，然后添加到VS Code设置：

{
  "cline.mcpServers": {
    "fluent": {
      "command": "uvx",
      "args": ["fluent-mcp-server"]
    }
  }
}

保存后重新加载VS Code窗口。

</details>

对于另外11个客户端 (Windsurf, Continue, Amp, Codex, Gemini CLI, Goose, Kiro, LM Studio, opencode, Qodo Gen, Warp)，请参阅**完整设置指南 →**

本地开发

# 克隆仓库
git clone https://github.com/your-org/fluent-mcp-server.git
cd fluent-mcp-server

# 使用uv安装
uv pip install -e ".[dev]"

# 运行测试
uv run pytest

# 运行服务器
uv run fluent-mcp-server

开发配置 (项目根目录下的.mcp.json)：

{
  "mcpServers": {
    "fluent": {
      "command": "uv",
      "args": [
        "--directory",
        "/绝对路径到/fluent-mcp-server",
        "run",
        "fluent-mcp-server"
      ]
    }
  }
}

可用工具

search_help

查找ANSYS Fluent文档URL。返回搜索URL和建议的手册部分。

参数：

• query (必需): 搜索词（例如，“火焰模型”，“读取案例”，“湍流”）
• max_suggestions (可选): 最大手册部分建议数（默认值：3）

返回：

• ANSYS帮助搜索URL
• 建议的手册部分（如果主题已预映射）
• 所有主要手册的链接

示例：

search_help("火焰模型")
# 返回：
# - 搜索URL: https://ansyshelp.ansys.com/search?q=火焰模型
# - 建议：火焰模型用户指南 + 理论指南
# - 所有手册：用户指南、TUI、理论、UDF

search_help("读取案例")
# 返回指向文件/读取案例TUI文档的URL

list_topics

列出35+主题及其预映射文档路径。

返回： 主题列表，如：文件、湍流、燃烧、火焰模型、网格、边界、UDF等。

示例：

list_topics()

get_manual_link

获取特定Fluent手册或部分的直接链接。

参数：

• manual (必需): 手册名称 (user_guide, tui, theory, udf)
• section (可选): 部分路径（例如，“湍流”，“文件/读取案例”）

示例：

get_manual_link("udf", "介绍")
# 返回: https://ansyshelp.ansys.com/.../flu_udf/介绍.html

使用示例

在Claude Code / AI助手中的使用

您: 如何在Fluent中使用火焰模型？
Claude: [调用search_help("火焰模型")]
        [接收火焰模型文档的URL]
        [使用WebFetch读取实际文档]
        [根据官方ANSYS文档提供答案]

您: 显示我读取案例文件的命令
Claude: [调用search_help("读取案例")]
        [获取指向文件/读取案例TUI命令的URL]
        [检索文档并显示语法]

架构流程

用户查询 → MCP search_help → 返回URL →
LLM使用WebFetch → 读取官方文档 → 回答用户

MCP服务器充当智能导航器，而不是内容数据库。

架构

fluent-mcp-server/
├── src/fluent_mcp_server/
│   ├── server.py          # FastMCP服务器及工具定义
│   ├── doc_finder.py      # 智能URL路由器（35+主题映射）
│   └── __init__.py
├── md-files/
│   ├── ARCHITECTURE.md    # 技术架构
│   └── ...
├── tests/                 # 单元测试
├── examples/              # 使用示例
└── pyproject.toml        # 项目配置

发展路线图

阶段1.x: 路径扩展（未来）

• 根据使用模式增加更多主题路径
• 版本选择（v251, v252, v253）
• 使用分析以识别热门主题

阶段2: PyFluent集成（计划中）

• 连接到Fluent会话
• 编程执行TUI命令
• 通过PyFluent API进行案例I/O
• 网格质量自动化
• 收敛监控

阶段3: 工作流自动化（计划中）

• 边界条件模板
• 求解器配置向导
• 后处理自动化
• 参数研究

详情请参阅md-files/ARCHITECTURE.md。

文档

入门：

• md-files/QUICKSTART.md - 设置和使用指南
• README.md - 本文件（概述）

技术文档：

• md-files/ARCHITECTURE.md - 系统架构与设计
• md-files/TOOLS.md - 完整工具目录
• md-files/ANSYS_HELP_GUIDE.md - ANSYS帮助站点模式

验证与分析：

• md-files/REDDIT_REAL_WORLD_EXAMPLES.md - 实际用户问题
• md-files/GAP_ANALYSIS.md - 覆盖范围分析
• md-files/USERSTORY.md - 用户场景

开发：

• examples/ - 使用示例
• tests/ - 单元测试

许可证

MIT许可证

贡献

欢迎贡献！请确保：

• 测试通过：uv run pytest
• 代码遵循现有风格
• 更新文档

fluent-mcp-server