MCP代理服务

一个基于OpenAI API的代理服务,提供与MCP stdio和sse服务器的连接配置和调试功能。

  • by DmytroFesyk
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 DmytroFesyk/agen-mcp-workshop

使用说明

开始入门

构建MCP标准输入输出库(或:构建MCP stdio环境/系统)

  • 进入 mcp-stdio 目录
  • 构建JAR文件
mvn clean install
  • 检查jar文件是否在目标目录中

运行MCP(多计算机处理/管理控制程序等,具体含义根据上下文确定)sse(可能是指某种特定的服务、系统或子模块,具体需根据上下文解释)

  • 进入mcp-see目录
  • 运行服务
mvn clean spring-boot:run

运行代理

  • 代理客户端(或:代理目录,具体取决于上下文,但“cd agent”通常不是标准术语,这里提供一种可能的解释)
  • 在代理中提供您的OpenAI API密钥 application-local.yaml
spring:
  ai:
    openai:
      api-key: ${OPENAI_API_KEY}
  • [可选] 选择如何配置与标准输入输出服务器的连接 已配置选项
spring:
  ai:
    mcp:
      client:
        stdio:
          connections:
            scheduler-mcp-stdio:
              command: java
              args:
                - -jar
                - ${basedir}/mcp-stdio/target/mcp-stdio-0.0.1-SNAPSHOT.jar

basedir: @parent.basedir@

通过JSON使用清单文件的替代选项

spring:
  ai:
    mcp:
      client:
        stdio:
          connections:
            servers-configuration: classpath:/mcp-server-configs.json

你应该指定过时的路径到 mcp-stdio-0.0.1-SNAPSHOT.jar

{
  "mcpServers": {
    "scheduler-mcp-stdio": {
      "command": "java",
      "args": [
        "-jar",
        "${your.path}/agen-mcp-workshop/mcp-stdio/target/mcp-stdio-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}
  • 运行服务
mvn clean spring-boot:run

使用代理API进行操作

  • 使用 test.http 包含简单预定义请求的文件

[可选] 启动用户界面

  • CD前端代理
  • 运行服务
npm install
npm run dev

额外的贬低功能

使用MCP检查器

  • 运行MCP检查器
npx @modelcontextprotocol/inspector
  • 连接到MCP Studio服务器。选择 transpot type=STDIO Command =java -jar ${your.path}/agen-mcp-workshop/mcp-stdio/target/mcp-stdio-0.0.1-SNAPSHOT.jar 并按下连接按钮
  • 连接到MCP SSE服务器。选择 transpot type=SSE URL=http://localhost:8090/scheduler/sse Connection Type=Via proxy 并按下连接按钮
  • 与MCP一起玩