MakingMcp

English | 中文

概述

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

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

预备条件

• .NET SDK 10.0 或更高版本

快速开始

下载

从 GitHub Releases 下载预构建的二进制文件：

• MakingMcp-win-x64.zip - Windows 标准输入输出模式
• MakingMcp-linux-x64.zip - Linux 标准输入输出模式
• MakingMcp-osx-x64.zip - macOS 标准输入输出模式
• MakingMcp-Web-win-x64.zip - Windows Web 服务模式
• MakingMcp-Web-osx-x64.zip - macOS Web 服务模式

标准输入输出模式

1. 解压下载的包
2. 运行可执行文件：
   • Windows: MakingMcp.exe
   • Linux/macOS: ./MakingMcp

Web 服务模式

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

2. 作为常规 Web 应用程序运行：

   • Windows: MakingMcp.Web.exe
   • macOS: ./MakingMcp.Web

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

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

   MakingMcp.Web.exe install
   

   安装后服务将自动启动。

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

   MakingMcp.Web.exe uninstall
   

配置

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

• OPENAI_API_KEY - Task 工具的 OpenAI API 密钥
• OPENAI_ENDPOINT - 自定义 OpenAI 端点（可选）
• TASK_MODEL - Task 工具的模型名称（例如，gpt-4）
• EMBEDDING_MODEL - 嵌入模型（默认：text-embedding-3-small）
• MAX_OUTPUT_TOKENS - 最大输出标记数（默认：32000）
• TAVILY_API_KEY - Web 搜索工具的 Tavily API 密钥

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

文件夹结构

• src/MakingMcp/ – 标准输入输出模式应用程序入口点
• src/MakingMcp.Web/ – Web 服务模式应用程序入口点
• src/MakingMcp.Shared/ – 共享代码（工具、选项、模型）
  • Tools/ – MCP 工具（文件、网络、bash、代理、任务）
  • Options/ – 配置对象
  • Model/ – 共享数据传输对象
• bin/, obj/ – 构建输出和临时资产（不在版本控制中）

贡献

遵循 AGENTS.md 中的仓库指南，使用 dotnet format 格式化代码，并提供与相关测试配对的专注提交。当工具输出改变时，打开一个带有清晰总结、验证步骤以及任何支持截图或日志的拉取请求。

微信