convez.ai
MCP ServerAutomaçãoAvançado
balajigk97

BGK MCP Server

balajigk97/bgk-mcp

Servidor MCP enterprise com 62 tools, multi-agente e grafo de conhecimento

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP pessoal com suporte multi-agente e plataforma de ferramentas extensível. Oferece 62 ferramentas distribuídas em 18 categorias (DevOps, observabilidade, bancos de dados, produtividade), com transporte multi-modo (stdio e HTTP/SSE) e gerenciamento de agentes IA customizáveis.

Instalação

$npx convez-ai balajigk97/bgk-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integração com Claude Desktop e VS Code Copilot para acesso a ferramentas corporativas
  • Automação de operações DevOps, monitoramento e CI/CD via agentes IA
  • Consultas em múltiplos bancos de dados (PostgreSQL, MySQL, Snowflake) com orquestração inteligente

Veredito

Solução robusta e bem-engenheirada para equipes que querem MCP com escala corporativa, mas requer expertise em Bun/TypeScript e configuração extensa de credenciais. Excelente para DevOps e SREs que buscam unificar ferramentas heterogêneas.

README

A tradução para o português deste README ainda está na fila.

BGK MCP Server

Personal MCP (Model Context Protocol) server with multi-agent support, extensible tool platform.

Features

  • 62 Tools across 18 categories — DevOps, observability, databases, productivity, and more
  • 6 Prompts — Code security, performance, smell detection, diagrams, test plans
  • Multi-transport: stdio (for VS Code Copilot, Claude Desktop) + HTTP/SSE (for web access)
  • Tool System: Decorator-based auto-discovery with Zod schema validation
  • Prompt System: @Prompt decorator with handler registry
  • Multi-Agent: Create, manage, and invoke AI agents with customizable roles
  • Configuration: YAML-based tool filtering (.bgkmcp.yaml) with glob patterns
  • CLI Commands: list-tools, doctor, generate-config, view-logs
  • Knowledge Graph: Persistent entity/relationship storage for LLM memory
  • Task Management: Local task list with priorities, tags, and filtering
  • Extensible: Easy scaffolding for new tools via bun run new:tool
  • Cross-Platform: Works on Windows, macOS, and Linux

Prerequisites

  • Bun v1.3.11 or later
  • Node.js 22+ (optional, for fallback)
  • Git

Setup (Complete Steps)

1. Install Bun

macOS / Linux:

curl -fsSL https://bun.sh/install | bash

Windows:

irm bun.sh/install.ps1 | iex

Verify installation:

bun --version

2. Clone or Copy the Project

# If using git
git clone <your-repo-url> ~/bgk-mcp
cd ~/bgk-mcp

# Or on Windows
git clone <your-repo-url> C:\Users\BPRAKASH\Downloads\personal-git\bgk-mcp
cd C:\Users\BPRAKASH\Downloads\personal-git\bgk-mcp

3. Install Dependencies

bun install

4. Configure Environment

cp .env.example .env

Edit .env with your values:

VariablePurposeRequired For
DATABASE_URLPostgreSQL connection stringdatabase tools
MYSQL_URLMySQL connection stringmysql tool
SEARCH_API_KEYGoogle Custom Search API keyweb-search
SEARCH_ENGINE_IDGoogle Programmable Search Engine IDweb-search
GITHUB_TOKENGitHub Personal Access Tokengithub tools
AGENT_API_KEYOpenAI/Anthropic API keyagent-run
AGENT_MODELDefault model (e.g., gpt-4, claude-3-opus)agent-run
SLACK_BOT_TOKENSlack Bot OAuth tokenslack tools
DATADOG_API_KEYDatadog API keydatadog tools
DATADOG_APP_KEYDatadog Application keydatadog tools
PAGERDUTY_API_KEYPagerDuty API tokenpagerduty tools
NEW_RELIC_API_KEYNew Relic User API keynewrelic tools
NEW_RELIC_ACCOUNT_IDNew Relic Account IDnewrelic tools
SPLUNK_HOSTSplunk instance URLsplunk tools
SPLUNK_TOKENSplunk auth tokensplunk tools
JENKINS_URLJenkins server URLjenkins tools
JENKINS_USERJenkins usernamejenkins tools
JENKINS_TOKENJenkins API tokenjenkins tools
SALESFORCE_ACCESS_TOKENSalesforce access tokensalesforce tools
SALESFORCE_INSTANCE_URLSalesforce instance URLsalesforce tools
SONARQUBE_URLSonarQube server URLsonar tools
SONARQUBE_TOKENSonarQube auth tokensonar tools
LAUNCHDARKLY_API_KEYLaunchDarkly API keylaunchdarkly tools
SNOWFLAKE_ACCOUNTSnowflake account identifiersnowflake tool
SNOWFLAKE_USERSnowflake usernamesnowflake tool
SNOWFLAKE_PASSWORDSnowflake passwordsnowflake tool
OCTOPUS_API_URLOctopus Deploy URLoctopus tools
OCTOPUS_API_KEYOctopus Deploy API keyoctopus tools
SOLARWINDS_API_URLSolarWinds SWIS URLsolarwinds tools
SOLARWINDS_USERNAMESolarWinds usernamesolarwinds tools
SOLARWINDS_PASSWORDSolarWinds passwordsolarwinds tools
VERACODE_API_IDVeracode API IDveracode tools
VERACODE_API_KEYVeracode API Keyveracode tools
SWAGGER_HUB_API_KEYSwaggerHub API keyswagger-hub tools
PORTHTTP server port (default: 3100)Optional
HOSTHTTP server host (default: localhost)Optional

Note: Only configure the variables for the tools you plan to use. Tools with missing env vars will still register but return an error when invoked.

5. Verify Setup

# Type check
bun x tsc --noEmit --skipLibCheck

# Start in HTTP mode to test
bun run dev:http
# Expected output: [bgk-mcp] HTTP server running at http://localhost:3100

# Test health endpoint (in another terminal)
curl http://localhost:3100/health
# Expected: {"status":"ok","server":"bgk-mcp"}

6. Run Tests

bun test

Connect to MCP Clients

VS Code Copilot (Windows)

Edit %APPDATA%\Code\User\mcp.json:

{
  "servers": {
    "bgk-mcp": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "C:/Users/BPRAKASH/Downloads/personal-git/bgk-mcp/src/mcp.ts"]
    }
  }
}

VS Code Copilot (macOS)

Edit ~/Library/Application Support/Code/User/mcp.json:

{
  "servers": {
    "bgk-mcp": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "/Users/YOUR_USERNAME/bgk-mcp/src/mcp.ts"]
    }
  }
}

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bgk-mcp": {
      "command": "bun",
      "args": ["run", "/Users/YOUR_USERNAME/bgk-mcp/src/mcp.ts"]
    }
  }
}

Claude Desktop (Windows)

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "bgk-mcp": {
      "command": "bun",
      "args": ["run", "C:/Users/BPRAKASH/Downloads/personal-git/bgk-mcp/src/mcp.ts"]
    }
  }
}

Cursor IDE

Add to .cursor/mcp.json in your project or global config:

{
  "mcpServers": {
    "bgk-mcp": {
      "command": "bun",
      "args": ["run", "/path/to/bgk-mcp/src/mcp.ts"]
    }
  }
}

Running the Server

CommandDescription
bun run devstdio mode with hot reload (for MCP clients)
bun run dev:httpHTTP mode with hot reload (for web/API access)
bun run startstdio mode (production)
bun run start:httpHTTP mode (production)
bun run buildBuild to dist/

Built-in Tools (62 total)

Core

CategoryToolDescription
webwebSearchSearch the web via Google Custom Search
webwebFetchFetch and extract content from URLs
file-opsfileReadRead file contents
file-opsfileWriteWrite content to files
file-opsfileListList directory contents
databasedbQueryExecute PostgreSQL queries (with safety guards)
databasemysqlQueryExecute MySQL queries
code-helpersshellExecRun shell commands (blocks dangerous patterns)
code-helpersgitHelperGit status, log, diff, branch, stash
agentsagentCreateCreate a new AI agent with custom config
agentsagentListList all registered agents
agentsagentRunSend a task to an agent
agentsagentDeleteRemove a registered agent

Utility

CategoryToolDescription
utilitygetWeatherForecastWeather forecast (US, via NWS API)
utilitygetCurrentTimeGet time in any timezone
utilityconvertTimeConvert time between timezones
utilitylocationToCoordsGeocoding/reverse geocoding via Nominatim

Observability & Monitoring

CategoryToolDescription
datadogdatadogQueryMetricsQuery Datadog metrics time series
datadogdatadogListMonitorsList Datadog monitors
datadogdatadogSearchHostsSearch Datadog infrastructure hosts
newrelicnewrelicNrqlQueryExecute NRQL queries
newrelicnewrelicListEntitiesSearch New Relic entities
newrelicnewrelicGetEntityGet entity details
pagerdutypagerdutyListIncidentsList PagerDuty incidents
pagerdutypagerdutyGetIncidentGet incident details
pagerdutypagerdutyListServicesList PagerDuty services
splunksplunkSearchExecute Splunk SPL queries
splunksplunkListIndexesList Splunk indexes
solarwindssolarwindsQueryExecute SWIS queries
solarwindssolarwindsGetAlertsGet SolarWinds active alerts

DevOps & CI/CD

CategoryToolDescription
githubgithubGetRepoGet repository info
githubgithubListPRsList pull requests
githubgithubListIssuesList issues
githubgithubSearchCodeSearch code across repos
jenkinsjenkinsListBuildsList recent builds
jenkinsjenkinsGetBuildGet build details
jenkinsjenkinsTriggerBuildTrigger a build
octopusoctopusListProjectsList Octopus Deploy projects
octopusoctopusGetDeploymentsGet deployments
octopusoctopusGetProcessGet deployment process steps
launchdarklylaunchdarklyListFlagsList feature flags
launchdarklylaunchdarklyGetFlagGet flag details & targeting

Security & Quality

CategoryToolDescription
sonarsonarAnalyzeProjectGet SonarQube quality metrics
sonarsonarGetIssuesGet SonarQube issues
veracodeveracodeListAppsList Veracode applications
veracodeveracodeGetScanGet scan findings

Collaboration & APIs

CategoryToolDescription
slackslackSendMessageSend Slack messages
slackslackListChannelsList Slack channels
slackslackSearchMessagesSearch Slack messages
salesforcesalesforceQueryExecute SOQL queries
salesforcesalesforceGetObjectGet Salesforce records
swagger-hubswaggerhubSearchSearch OpenAPI specs
swagger-hubswaggerhubGetSpecGet API specifications

Data Warehouses

CategoryToolDescription
snowflakesnowflakeQueryExecute Snowflake SQL queries

Productivity

CategoryToolDescription
knowledge-graphknowledgeGraphAddNodeAdd entities to persistent graph
knowledge-graphknowledgeGraphAddEdgeAdd relationships
knowledge-graphknowledgeGraphSearchSearch the knowledge graph
knowledge-graphknowledgeGraphAddObservationAdd observations to entities
taskstasksCreateCreate tasks
taskstasksUpdateUpdate task status/priority
taskstasksListList/filter tasks
taskstasksDeleteDelete tasks

Adding New Tools

bun run new:tool

This prompts you for tool ID, name, description, and category, then scaffolds:

  • src/tools/<tool-id>/index.ts — Implementation
  • src/tools/<tool-id>/<tool-id>.test.ts — Test file

After adding, regenerate the loader:

bun run generate:tools

Configuration

Create a .bgkmcp.yaml in your project root or home directory to control which tools are available:

tools:
  include:
    - "github-*"
    - "slack-*"
    - "tasks-*"
  exclude:
    - "snowflake-*"

categories:
  include:
    - github
    - slack
    - utility
    - tasks
  exclude:
    - salesforce

Generate a template config with all tools listed:

bun run src/mcp.ts generate-config

Prompts

Built-in prompts for code analysis and documentation:

IDNameDescription
code-securityCode Security ReviewOWASP-style security analysis
code-performanceCode Performance AnalysisPerformance issue detection
code-smellCode Smell DetectionRefactoring suggestions
class-diagramGenerate Class DiagramMermaid class diagrams from code
flowchartGenerate FlowchartMermaid flowcharts from logic
test-planGenerate Test PlanComprehensive test plan generation

Multi-Agent System

Create specialized agents that can use subsets of your tools:

1. Create an agent:    agent-create (id, name, model, systemPrompt, tools)
2. List agents:        agent-list
3. Run an agent:       agent-run (agentId, message, context)
4. Delete an agent:    agent-delete (agentId)

Agents persist in-memory during the server session. Configure AGENT_API_KEY and AGENT_MODEL in .env.


Architecture

bgk-mcp/
├── src/
│   ├── mcp.ts              # CLI entry point (yargs commands)
│   ├── loader.ts           # Auto-imports all tool modules
│   ├── prompts-loader.ts   # Auto-imports all prompt modules
│   ├── config.ts           # YAML configuration system
│   ├── core/
│   │   ├── server.ts       # MCP server with tool + prompt handlers
│   │   ├── registry.ts     # Tool registry, @Tool decorator, middleware
│   │   ├── prompts.ts      # Prompt registry & @Prompt decorator
│   │   ├── decorators.ts   # @CatchErrors decorator
│   │   └── index.ts        # Core barrel exports
│   ├── commands/           # CLI commands (list-tools, doctor, etc.)
│   ├── tools/              # 27 tool directories, 62 tools total
│   │   ├── agents/         # Multi-agent CRUD & execution
│   │   ├── code-helpers/   # Shell exec & git helpers
│   │   ├── database/       # PostgreSQL queries
│   │   ├── datadog/        # Datadog metrics & monitors
│   │   ├── file-ops/       # File read/write/list
│   │   ├── github/         # GitHub repos, PRs, issues, code search
│   │   ├── jenkins/        # Jenkins builds
│   │   ├── knowledge-graph/# Persistent entity/relationship storage
│   │   ├── launchdarkly/   # Feature flags
│   │   ├── location/       # Geocoding
│   │   ├── mysql/          # MySQL queries
│   │   ├── newrelic/       # NRQL queries & entities
│   │   ├── octopus/        # Octopus Deploy
│   │   ├── pagerduty/      # Incidents & services
│   │   ├── salesforce/     # SOQL & objects
│   │   ├── slack/          # Messages & channels
│   │   ├── snowflake/      # Snowflake SQL
│   │   ├── solarwinds/     # SWIS queries & alerts
│   │   ├── sonar/          # SonarQube metrics & issues
│   │   ├── splunk/         # SPL search
│   │   ├── swagger-hub/    # OpenAPI specs
│   │   ├── tasks/          # Local task management
│   │   ├── time/           # Timezone operations
│   │   ├── veracode/       # Security scans
│   │   ├── weather/        # NWS forecasts
│   │   ├── web-search/     # Google Custom Search
│   │   └── webfetch/       # URL fetching & extraction
│   ├── prompts/            # 6 prompt templates
│   │   ├── analysis/       # Security, performance, code smell
│   │   ├── documentation/  # Class diagram, flowchart
│   │   └── testing/        # Test plan generation
│   ├── services/
│   │   └── logger.ts       # File-based logging with rotation
│   ├── transports/
│   │   └── http.ts         # Express + SSE transport
│   ├── types/
│   │   └── index.ts        # Shared TypeScript types
│   └── utils/
│       └── zod-to-json.ts  # Zod → JSON Schema converter
├── scripts/
│   ├── generate-tool-loader.ts
│   └── new-tool.ts
├── tests/
├── .env.example
├── package.json
├── tsconfig.json
└── bunfig.toml

Troubleshooting

ProblemSolution
bun: command not foundRestart terminal after installing Bun, or add ~/.bun/bin to PATH
Server won't startCheck bun install completed successfully
Tools not showing in clientEnsure the path in mcp.json/claude config is absolute and correct
SEARCH_API_KEY not setAdd keys to .env file
Cannot find moduleRun bun install again
Port already in useChange PORT in .env or kill the process on 3100

All Commands

bun run dev           # Dev mode (stdio + hot reload)
bun run dev:http      # Dev mode (HTTP + hot reload)
bun run start         # Production stdio
bun run start:http    # Production HTTP
bun run build         # Build binary
bun run test          # Run tests
bun run test:coverage # Tests with coverage
bun run typecheck     # TypeScript checks
bun run new:tool      # Scaffold a new tool
bun run generate:tools # Regenerate tool loader
bun run lint          # ESLint
bun run format        # Prettier

# CLI commands
bun run src/mcp.ts list-tools          # List all registered tools
bun run src/mcp.ts list-tools --json   # JSON output
bun run src/mcp.ts doctor              # Validate config
bun run src/mcp.ts generate-config     # Generate .bgkmcp.yaml template
bun run src/mcp.ts view-logs           # View server logs
bun run src/mcp.ts info                # Show server info
Ver o original no GitHub

Bom para

Relacionados