MCP启动器

一个跨平台的Go语言启动器,用于启动共享的MCP服务器,支持Tavily、Context7、Playwright、GitHub等多种服务。

  • by Yazington
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 Yazington/mcps

使用说明

MCP启动器(Go)

此文件夹包含 run-mcps.go,一个启动的跨平台Go启动器 用于Tavily、Context7、Playwright、GitHub、测试注册器/测试验证器、Agentation(所有这些都通过stdio->HTTP代理)和可选Storybook MCP服务器的共享MCP服务器。

前提条件

  • pnpm 在PATH上(用于运行MCP和 mcp-proxy)
  • GitHub MCP二进制文件(github-mcp-server 或 github-mcp-server.exe)在PATH或在 ~/bin
  • Agent云存储的可选配置: AGENTATION_API_KEY
  • Storybook MCP的可选项:一个具有以下功能的Storybook项目 @storybook/addon-mcp 启用于 .storybook/main.*
  • 可选固定代理MCP端口:设置 AGENTATION_MCP_PORT (默认为 7017)
  • 可选固定故事书端口:set STORYBOOK_PORT (默认为 7016)

构建二进制文件

go build -o run-mcps ./run-mcps.go

注: run-mcps 相对于二进制文件定位测试注册器/测试验证器文件夹(回退到当前工作目录)。保持 run-mcps 在repo根目录中或从repo根运行它。

在Windows上,您可能需要 run-mcps.exe:

go build -o run-mcps.exe .\run-mcps.go
git clone https://github.com/github/github-mcp-server
cd github-mcp-server\cmd\github-mcp-server
go build -o $env:USERPROFILE\bin\github-mcp-server.exe

示例:从主机传递env变量

Windows(PowerShell):

$env:TAVILY_API_KEY="tvly-..."
# Optional if your Context7 setup requires a key
$env:CONTEXT7_API_KEY="ctx7-..."
$env:GITHUB_PERSONAL_ACCESS_TOKEN="ghp-..."
# Optional: Storybook project root (if set, Storybook MCP will be started)
$env:STORYBOOK_DIR="E:\work\dg\app"
# Optional: fixed Agentation MCP port (default 7017)
$env:AGENTATION_MCP_PORT="7017"
# Optional: Agentation cloud API key
$env:AGENTATION_API_KEY="ag_..."
$env:STORYBOOK_PORT="7016"
.\run-mcps.exe

Windows(cmd.exe):

set TAVILY_API_KEY=tvly-...
REM Optional if your Context7 setup requires a key
set CONTEXT7_API_KEY=ctx7-...
set GITHUB_PERSONAL_ACCESS_TOKEN=ghp-...
REM Optional: Storybook project root
set STORYBOOK_DIR=E:\work\dg\app
REM Optional: fixed Agentation MCP port (default 7017)
set AGENTATION_MCP_PORT=7017
REM Optional: Agentation cloud API key
set AGENTATION_API_KEY=ag_...
REM Optional: fixed Storybook port (default 7016)
set STORYBOOK_PORT=7016
run-mcps.exe

macOS/Linux(bash/zsh):

export TAVILY_API_KEY="tvly-..."
# Optional if your Context7 setup requires a key
export CONTEXT7_API_KEY="ctx7-..."
export GITHUB_PERSONAL_ACCESS_TOKEN="ghp-..."
# Optional: Storybook project root
export STORYBOOK_DIR="/path/to/your/storybook/app"
export AGENTATION_MCP_PORT="7017"
# Optional: Agentation cloud API key
export AGENTATION_API_KEY="ag_..."
export STORYBOOK_PORT="7016"
./run-mcps

可选:通过标志传递

./run-mcps -tavily "tvly-..." -context7 "ctx7-..." -github "ghp-..." -agentation-port 7017 -storybook-dir "/path/to/your/storybook/app" -storybook-port 7016

代理MCP终点:

http://<host>:<agentation-port>/mcp

故事书MCP端点(启用故事书时):

http://<host>:<storybook-port>/mcp

如果 -storybook-dir / STORYBOOK_DIR 未设置, run-mcps 不会启动Storybook本身,但它现在会在配置的端口上检查已运行的外部Storybook MCP端点,并记录检测到的端点。