使用说明

项目简介

本项目 'mcpservers' 提供了一系列基于 Model Context Protocol (MCP) 协议实现的服务器，全部以 .NET 工具 (dotnet tool) 的形式发布。这些服务器旨在作为 LLM 应用的后端，提供上下文信息和工具能力，支持通过 Stdio 和 SSE 两种传输协议与 MCP 客户端进行通信。

主要功能点

资源访问: 'mcpserver.openxml' 系列服务器能够读取和解析 OpenXML 格式的文档（如 .docx 文件），提取文本内容，为 LLM 提供文档数据。
工具执行: 服务器注册并暴露各种工具，例如 'mcpserver.openxml' 提供了读取 Word 文档的工具，'mcpserver.everything' 提供了回声 (Echo) 和加法 (Add) 等通用工具。
多传输协议: 支持 Stdio (标准输入输出) 和 SSE (Server-Sent Events) 两种传输协议，满足不同应用场景的需求。
框架支持: 提供 'ModelContextProtocolServer.Stdio' 和 'ModelContextProtocolServer.Sse' 框架，简化 MCP 服务器的开发。
客户端工具: 包含 'mcpclient' 客户端工具，方便用户与 MCP 服务器进行交互和测试工具功能。

安装步骤

安装 .NET SDK: 确保已安装 .NET SDK (建议最新版本)。

安装 MCP 服务器 dotnet tool: 使用 'dotnet tool install --global' 命令安装所需的 MCP 服务器工具。例如，安装 'mcpserver.openxml.stdio' 服务器：

dotnet tool install --global mcpserver.openxml.stdio

或者安装 'mcpserver.everything.stdio' 服务器：

dotnet tool install --global mcpserver.everything.stdio

也可以选择安装支持 SSE 协议的服务器，例如 'mcpserver.openxml.sse':

dotnet tool install --global mcpserver.openxml.sse

服务器配置

MCP 客户端需要配置服务器连接信息才能与 MCP 服务器通信。以下是不同服务器类型的配置示例 (JSON 格式)：

1. Stdio 服务器 (例如 'mcpserver.openxml.stdio', 'mcpserver.everything.stdio') 配置：

{
  "serverName": "openxml-stdio-server",  // 自定义服务器名称，用于客户端标识
  "transportType": "stdio",             // 传输类型为 Stdio
  "command": "mcpserver.openxml.stdio", // 启动服务器的命令 (dotnet tool 名称)
  "args": []                             // 启动参数，本例中无需参数
}

注意:

'serverName' 可以自定义，用于在客户端区分不同的服务器连接。
'transportType' 必须设置为 '"stdio"'。
'command' 需要设置为已安装的 dotnet tool 名称 (例如 'mcpserver.openxml.stdio')。
'args' 可以根据服务器需求添加启动参数，本例中 'mcpserver.openxml.stdio' 和 'mcpserver.everything.stdio' 默认无需额外参数。

2. SSE 服务器 (例如 'mcpserver.openxml.sse') 配置：

{
  "serverName": "openxml-sse-server",   // 自定义服务器名称
  "transportType": "sse",              // 传输类型为 SSE
  "location": "http://localhost:5000/sse" // SSE 服务器的地址，默认为 http://localhost:5000/sse
}