Making MCP

MakingMcp

英语 | 中文

概述

MakingMcp提供了一个模型上下文协议（MCP）服务器实现，该实现通过依赖注入集成了文件、web、shell和委托代理工具。该项目提供两种部署模式：

• 标准模式 (src/MakingMcp)-使用标准输入/输出的传统命令行MCP服务器
• Web服务模式 (src/MakingMcp.Web)基于HTTP的MCP服务器，支持Windows服务

先决条件

• .NET SDK 10.0或更高版本

入门指南

下载

从下载预构建的二进制文件 :

• 制作Mcp-win-x64.zip -Windows的标准模式
• 制作Mcp-linux-x64.zip -Linux的标准模式
• 制作Mcp-osx-x64.zip -macOS的标准模式
• 制作Mcp-Web-win-x64.zip -Windows的Web服务模式
• 制作Mcp-Web-osx-x64.zip -macOS的Web服务模式

标准模式

1. 解压缩下载的软件包
2. 运行可执行文件：

- 视窗: MakingMcp.exe - Linux/macOS: ./MakingMcp

Web服务模式

1. 解压下载的包（MakingMcp Web-\*.zip）

1. 作为常规web应用程序运行：

- 视窗: MakingMcp.Web.exe - macOS: ./MakingMcp.Web

MCP端点将在 http://localhost:6511/mcp （或根据您的环境配置）。

1. 作为Windows服务安装 （需要管理员权限）：

   MakingMcp.Web.exe install

安装后，该服务将自动启动。

1. 卸载Windows服务 （需要管理员权限）：

   MakingMcp.Web.exe uninstall

配置

这两种模式都支持通过环境变量进行配置：

• OPENAI_API_KEY -任务工具的OpenAI API密钥
• OPENAI_ENDPOINT -自定义OpenAI端点（可选）
• TASK_MODEL -任务工具的型号名称（例如gpt-4）
• EMBEDDING_MODEL -嵌入模型（默认：text-Embedding-3-small）
• MAX_OUTPUT_TOKENS -最大输出令牌（默认值：32000）
• TAVILY_API_KEY -Tavilly API关键字用于Web搜索工具

对于Web服务模式，您还可以使用 appsettings.json 用于配置。

文件夹结构

• src/MakingMcp/ –标准模式应用程序入口点
• src/MakingMcp.Web/ –Web服务模式应用程序入口点
• src/MakingMcp.Shared/ –共享代码（工具、选项、模型）

- Tools/ –MCP工具（文件、web、bash、代理、任务） - Options/ –配置对象 - Model/ –共享DTO

• bin/, obj/ –构建输出和临时资产（不受版本控制）

贡献

遵循中的存储库指南 AGENTS.md，格式代码为 dotnet format，并提供有针对性的提交和相关测试。打开一个拉取请求，其中包含清晰的摘要、验证步骤以及工具输出更改时的任何支持屏幕截图或日志。

微信