模型上下文协议服务器

MakingMcp是一个提供文件、网络、Shell和代理工具集成的模型上下文协议(MCP)服务器实现,支持标准输入/输出和HTTP两种部署模式。

  • by AIDotNet
  • C#
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 AIDotNet/MakingMcp

使用说明

MakingMcp

英语 | 中文

概述

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

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

先决条件

  • .NET SDK 10.0或更高版本

入门指南

下载

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

  • 制作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)

  2. 作为常规web应用程序运行:

    • 视窗: 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 -任务工具的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,并提供有针对性的提交和相关测试。打开一个拉取请求,其中包含清晰的摘要、验证步骤以及工具输出更改时的任何支持屏幕截图或日志。

微信