Fluent MCP Server

ANSYS Fluent MCP服务器

模型上下文协议（MCP）服务器，帮助AI助手高效地浏览ANSYS Fluent在线文档。

特性

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

快速开始

先决条件

• Python 3.10或更高版本
• 紫外线 包管理器

安装

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

Claude Code (CLI)

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

验证：

claude mcp list
claude mcp info fluent

Claude Desktop

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

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

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

保存后完全重新启动Claude Desktop。

Cursor

首选 Cursor Settings → MCP → Add new MCP Server:

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

或编辑配置文件：

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

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

VS Code (GitHub Copilot)

CLI：

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

或添加到VS代码设置：

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

Cline (VS Code Extension)

安装 临床扩展，然后添加到VS代码设置中：

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

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

新增11名客户 （Windsurf、Continue、Amp、Codex、Gemini CLI、Goose、Kiro、LM Studio、opencode、Qodo Gen、Warp），请参阅 完整安装指南→

地方发展

# Clone the repository
git clone https://github.com/your-org/fluent-mcp-server.git
cd fluent-mcp-server

# Install with uv
uv pip install -e ".[dev]"

# Run tests
uv run pytest

# Run server
uv run fluent-mcp-server

开发配置 (.mcp.json 在项目根目录中）：

{
  "mcpServers": {
    "fluent": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/fluent-mcp-server",
        "run",
        "fluent-mcp-server"
      ]
    }
  }
}

可用工具

search_help

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

参数：

• query （必填）：搜索词（例如，“小火焰模型”、“读取案例”、“湍流”）
• max_suggestions （可选）：最大手动部分建议（默认值：3）

退货：

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

例子：

search_help("flamelet model")
# Returns:
# - Search URL: https://ansyshelp.ansys.com/search?q=flamelet+model
# - Suggested: flamelet User Guide + Theory Guide
# - All manuals: User Guide, TUI, Theory, UDF

search_help("read case")
# Returns URLs to file/read-case TUI documentation

list_topics

列出35多个主题，并预先映射文档路线。

退货： 主题列表，如：文件、湍流、燃烧、火焰、网格、边界、udf等。

例子：

list_topics()

get_manual_link

获取特定Fluent手册或章节的直接链接。

参数：

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

例子：

get_manual_link("udf", "introduction")
# Returns: https://ansyshelp.ansys.com/.../flu_udf/introduction.html

用法示例

In Claude Code/AI助手

You: How do I use the flamelet model in Fluent?
Claude: [Calls search_help("flamelet model")]
        [Receives URLs to flamelet documentation]
        [Uses WebFetch to read the actual documentation]
        [Provides answer based on official ANSYS docs]

You: Show me the command to read a case file
Claude: [Calls search_help("read case")]
        [Gets URL to file/read-case TUI command]
        [Retrieves documentation and shows syntax]

架构流程

User Query → MCP search_help → Returns URLs →
LLM uses WebFetch → Reads official docs → Answers user

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

建筑

fluent-mcp-server/
├── src/fluent_mcp_server/
│   ├── server.py          # FastMCP server & tool definitions
│   ├── doc_finder.py      # Smart URL router (35+ topic mappings)
│   └── __init__.py
├── md-files/
│   ├── ARCHITECTURE.md    # Technical architecture
│   └── ...
├── tests/                 # Unit tests
├── examples/              # Usage examples
└── pyproject.toml        # Project configuration

路线图

1.x阶段：路线扩建（未来）

• 根据使用模式添加更多主题路线
• 版本选择（v251、v252、v253）
• 使用分析来识别热门话题

第二阶段：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
• 代码遵循现有样式
• 文件已更新

流畅的mcp服务器