Reqnroll MCP Server

ReqnRollMcpServer

这是MCP（模型上下文协议）服务器的概念验证（PoC）实现，用于 请求列表 绑定，使AI代理能够获取有关可用绑定的信息。

使命宣言

该项目旨在通过允许AI代理以适合AI代理的格式直接查询可用的ReqnRoll绑定及其文档，最大限度地减少人工智能幻觉，并为代理提供必要的上下文，从而简化ReqnLoll功能文件的创建。

使MCP服务器可供AI代理使用

带有GitHub Copilot扩展的Visual Studio代码

假设您在Visual Studio Code中安装了GitHub Copilot扩展，您可以按如下方式配置它以使用MCP服务器：

1. 如果尚未打开，请打开GitHub Copilot聊天，例如按 CTRL+ALT+I 或者为您的环境配置的任何快捷方式。
2. 确保GitHub Copilot在聊天窗口左下角设置为“Agent”。
3. 单击聊天底部模型选择旁边的扳手和螺丝刀小图标。在Visual Studio代码窗口的顶部，将打开可用MCP服务器的列表。
4. 单击可用MCP服务器列表顶部标记为“添加MCP服务器…”的小图标。
5. 接下来，选择“命令（stdio）”。
6. 在提示中输入以下命令并确认：

dnx Rotbarsch.ReqnrollMcpServer --yes

1. 为您的配置输入一个唯一且信息丰富的名称，例如“ReqnRoll MCP服务器”。
2. 名为的文件 mcp.json 位于您的 %APPDATA%/Code/User 目录将打开。它应该看起来像这样：

{
	"servers": {
		"ReqnRollMcp": {
			"type": "stdio",
			"command": "dnx",
			"args": [
				"Rotbarsch.ReqnrollMcpServer",
				"--yes"
			]
		}
	},
	"inputs": []
}

1. 保存文件。注意小 Start JSON节点顶部的提示，描述您新添加的MCP服务器。单击它以启动服务器。如果出现任何问题，Visual Studio Code将显示服务器的控制台输出以及详细的堆栈跟踪。
2. 再次单击扳手和螺丝刀图标现在将显示您的MCP服务器。如果旁边的复选框未选中，请选中它。
3. GitHub Copilot现在可以使用了。尝试用以下方式提示：

List all available ReqnRoll bindings.

1. 在首次使用特定功能（在MCP世界中称为“工具”）之前，聊天将通过提示请求您的许可。

确认该提示后，您应该得到一个答案，其中列出了定义程序集中所有可用的ReqnRoll绑定。

Visual Studio与GitHub Copilot

1. 打开“GitHub Copilot聊天”窗口。
2. 点击聊天窗口右下角标有“选择工具”的小扳手图标。打开可用MCP服务器列表。
3. 单击工具列表右上角的绿色小加号。将打开一个新对话框。
4. 填写对话框：

{
  "inputs": [],
  "servers": {
    "ReqnRollBindings": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "Rotbarsch.ReqnrollMcpServer",
        "--yes"
      ],
      "env": {}
    }
  }
}

1. 单击“保存”。MCP服务器现在已添加到可用工具列表中。
2. GitHub Copilot现在可以使用了。尝试用以下方式提示：

List all available ReqnRoll bindings.

1. 在首次使用特定功能（在MCP世界中称为“工具”）之前，聊天将通过提示请求您的许可。

确认该提示后，您应该得到一个答案，其中列出了定义程序集中所有可用的ReqnRoll绑定。

“无法加载类型”和类似消息

确保程序集的所有依赖项都位于要检查的程序集旁边。实现这一点的最简单方法是设置可运行、可构建的ReqnRoll项目引用的路径，并使用这些绑定而不是绑定项目本身。

文档XML找不到

根据绑定csproj文件的配置，XML文档并不总是复制到输出目录。 在这种情况下，要么调整绑定项目以将XML文档复制到输出目录，要么在中手动提供XML文档的路径 inputs.json. 如果是nuget包，请检查 %HOMEPATH%/.nuget/packages 对于XML文档文件。

额外奖励：Markdown文档生成器

从程序集中提取Reqnroll绑定的markdown文档的功能也可以作为独立的命令行工具使用。

通过以下方式使用：

dnx Rotbarsch.ReqnrollDocumentationGenerator -i "
;
" -i "
;
" -o ""

例子：

dnx Rotbarsch.ReqnrollDocumentationGenerator -i "..\TestProject\MyBindings.dll;..\TestProject\MyBindings.xml" -o "Bindings.md"

您可以拨打以下电话获取更多信息：

dnx Rotbarsch.ReqnrollDocumentationGenerator --help

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

对第三方的依赖

有关依赖项许可证的信息可以在 第三方通知 文件。