英语

□ 概览 MakingMcp提供了一个模式上下文协议(MCP)服务器执行,通过依赖性注入将文件,网络, shell,和授权代理工具整合在一起. 该项目提供两种部署模式:

• Stdio Mode([[T0])-使用标准输入/输出的传统命令行MCP服务器
• Web服务模式 ([[T1])-基于HTTP的有Windows服务支持的MCP服务器

□ 先决条件

• .NET SDK 10.0或以后

∮开始∮

下载 从 GitHub 版本下载预建的二进制 :

• ** MakingMcp-win-x64.zip** - Windows的Stdio模式
• ** MakingMcp-linux-x64.zip** - 用于Linux的Stio模式
• ** MakingMcp-osx-x64.zip** - macOS的Stio模式
• ** MakingMcp-Web-win-x64.zip** - Windows的网络服务模式
• ** MakingMcp-Web-osx-x64.zip** - macOS的网络服务模式

QQ Stdio 模式

1. 提取已下载的软件包
2. 运行可执行文件:

• 窗户:MakingMcp.exe
• ** Linux/macOS**:./MakingMcp

QQ 网络服务模式

1. 提取已下载的软件包(MakingMcp-Web-*.zip)
2. 作为常规网络应用程序运行:

• 窗户:MakingMcp.Web.exe
• macOS:./MakingMcp.Web

MakingMcp

English | 中文

Overview

MakingMcp provides a Model Context Protocol (MCP) server implementation that integrates file, web, shell, and delegated-agent tooling through dependency injection. The project offers two deployment modes:

• Stdio Mode (src/MakingMcp) - Traditional command-line MCP server using standard input/output
• Web Service Mode (src/MakingMcp.Web) - HTTP-based MCP server with Windows Service support

Prerequisites

• .NET SDK 10.0 or later

Getting Started

Download

Download the pre-built binaries from GitHub Releases:

• MakingMcp-win-x64.zip - Stdio mode for Windows
• MakingMcp-linux-x64.zip - Stdio mode for Linux
• MakingMcp-osx-x64.zip - Stdio mode for macOS
• MakingMcp-Web-win-x64.zip - Web service mode for Windows
• MakingMcp-Web-osx-x64.zip - Web service mode for macOS

Stdio Mode

1. Extract the downloaded package
2. Run the executable:
   • Windows: MakingMcp.exe
   • Linux/macOS: ./MakingMcp

Web Service Mode

1. Extract the downloaded package (MakingMcp-Web-*.zip)

2. Run as a regular web application:

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

   The MCP endpoint will be available at http://localhost:6511/mcp (or as configured in your environment).

3. Install as Windows Service (requires Administrator privileges):

   MakingMcp.Web.exe install
   

   The service will be automatically started after installation.

4. Uninstall Windows Service (requires Administrator privileges):

   MakingMcp.Web.exe uninstall
   

Configuration

Both modes support configuration through environment variables:

• OPENAI_API_KEY - OpenAI API key for Task tool
• OPENAI_ENDPOINT - Custom OpenAI endpoint (optional)
• TASK_MODEL - Model name for Task tool (e.g., gpt-4)
• EMBEDDING_MODEL - Embedding model (default: text-embedding-3-small)
• MAX_OUTPUT_TOKENS - Maximum output tokens (default: 32000)
• TAVILY_API_KEY - Tavily API key for Web search tool

For Web Service mode, you can also use appsettings.json for configuration.

Folder Structure

• src/MakingMcp/ – Stdio mode application entry point
• src/MakingMcp.Web/ – Web service mode application entry point
• src/MakingMcp.Shared/ – Shared code (tools, options, models)
  • Tools/ – MCP tools (file, web, bash, agent, task)
  • Options/ – Configuration objects
  • Model/ – Shared DTOs
• bin/, obj/ – Build output and transient assets (not under version control)

Contributing

Follow the repository guidelines in AGENTS.md, format code with dotnet format, and provide focused commits paired with relevant tests. Open a pull request with a clear summary, validation steps, and any supporting screenshots or logs when tool outputs change.

WeChat