返回市场
XML.Revit.MCP服务器

XML.Revit.MCP服务器

作者:ZedMoster3 星标更新:2025-04-04

项目介绍

如何创建和生成供CallFunc调用的MCP DLL文件

本文档解释了如何创建一个MCP DLL文件以调用CallFunc方法。 MCP DLL文件需要实现接口xml.Revit.MCP.Public.MCPMethod, 并根据JSON-RPC 2.0规范与Revit的MCP服务进行交互。

MCP DLL的结构和实现

创建一个实现类

实现IMCPMethod接口

以下是一个用于创建标高并返回新的标高ElementModelRequest的实现类示例:

using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using Autodesk.Revit.DB;
using Autodesk.Revit.DB.Architecture;
using Autodesk.Revit.DB.Structure;
using Autodesk.Revit.UI;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using xml.Revit.MCP.Models;
using xml.Revit.MCP.Public;
using xml.Revit.Toolkit.Attributes;
using xml.Revit.Toolkit.Extensions;
using xml.Revit.Toolkit.Utils;

namespace xml.Revit.MCPServer
{
    /// <summary>
    /// 实现新增标高功能的类,继承自 IMCPMethod 接口。
    /// </summary>
    public sealed class TopLevelAdd : IMCPMethod
    {
        /// <summary>
        /// 构造函数,初始化方法名称。
        /// </summary>
        public TopLevelAdd()
        {
            MethodName = "新增标高";
        }

        /// <summary>
        /// 方法名称,用于标识当前功能。
        /// </summary>
        public string MethodName { get; private set; }

        /// <summary>
        /// 执行新增标高的核心逻辑。
        /// </summary>
        /// <param name="request">包含请求参数的 JsonRPCRequest 对象。</param>
        /// <param name="uidoc">当前 Revit 的 UIDocument 对象。</param>
        /// <returns>返回一个 JsonRPCResponse 对象,包含执行结果。</returns>
        public JsonRPCResponse Execute(JsonRPCRequest request, UIDocument uidoc)
        {
            // 初始化响应对象
            var jsonResponse = new JsonRPCResponse();

            // 获取当前文档
            var doc = uidoc.Document;

            // 默认标高偏移量,单位为毫米
            double elevationOffset = 3000d;

            // 从请求参数中解析标高偏移量
            var obj = request.Params as JObject;
            if (obj != null)
            {
                elevationOffset = obj["offset"].Value<double>();
            }

            // 获取文档中的最高标高
            var highestLevel = doc.OfClass<Level>().OrderBy(l => l.Elevation).LastOrDefault();
            if (highestLevel == null)
            {
                throw new InvalidOperationException("未找到有效的标高。");
            }

            // 开启事务并创建新标高
            doc.Transaction(t =>
            {
                var newLevel = Level.Create(
                    doc,
                    highestLevel.Elevation + elevationOffset.MMToFeet() // 偏移量转换为英尺
                );

                // 将新标高信息封装到响应结果中
                jsonResponse.Result = new ElementModelRequest(newLevel);
            });

            return jsonResponse; // 返回响应对象
        }
    }
}

在Visual Studio中编译项目并生成.dll文件。 编译后,请确保生成的.dll文件位于指定的MCP文件夹中。 mcp-dll.png

通过以上步骤,您可以轻松创建和生成MCP DLL文件,并将其集成到Revit的MCP服务中进行动态调用。

通过函数名称调用功能.png

mcp-tool

Call_func 点击此处查看源码实现

直接通过大模型CallFunc点击提示词即可实现

response = call_func(ctx, params=[
    {"name": "新增标高", "params": {"offset": 3000}}
])