BGK MCP Server
balajigk97/bgk-mcp
Servidor MCP enterprise com 62 tools, multi-agente e grafo de conhecimento
Ver no GitHubServidor 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-mcp1 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
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:
@Promptdecorator 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:
| Variable | Purpose | Required For |
|---|---|---|
DATABASE_URL | PostgreSQL connection string | database tools |
MYSQL_URL | MySQL connection string | mysql tool |
SEARCH_API_KEY | Google Custom Search API key | web-search |
SEARCH_ENGINE_ID | Google Programmable Search Engine ID | web-search |
GITHUB_TOKEN | GitHub Personal Access Token | github tools |
AGENT_API_KEY | OpenAI/Anthropic API key | agent-run |
AGENT_MODEL | Default model (e.g., gpt-4, claude-3-opus) | agent-run |
SLACK_BOT_TOKEN | Slack Bot OAuth token | slack tools |
DATADOG_API_KEY | Datadog API key | datadog tools |
DATADOG_APP_KEY | Datadog Application key | datadog tools |
PAGERDUTY_API_KEY | PagerDuty API token | pagerduty tools |
NEW_RELIC_API_KEY | New Relic User API key | newrelic tools |
NEW_RELIC_ACCOUNT_ID | New Relic Account ID | newrelic tools |
SPLUNK_HOST | Splunk instance URL | splunk tools |
SPLUNK_TOKEN | Splunk auth token | splunk tools |
JENKINS_URL | Jenkins server URL | jenkins tools |
JENKINS_USER | Jenkins username | jenkins tools |
JENKINS_TOKEN | Jenkins API token | jenkins tools |
SALESFORCE_ACCESS_TOKEN | Salesforce access token | salesforce tools |
SALESFORCE_INSTANCE_URL | Salesforce instance URL | salesforce tools |
SONARQUBE_URL | SonarQube server URL | sonar tools |
SONARQUBE_TOKEN | SonarQube auth token | sonar tools |
LAUNCHDARKLY_API_KEY | LaunchDarkly API key | launchdarkly tools |
SNOWFLAKE_ACCOUNT | Snowflake account identifier | snowflake tool |
SNOWFLAKE_USER | Snowflake username | snowflake tool |
SNOWFLAKE_PASSWORD | Snowflake password | snowflake tool |
OCTOPUS_API_URL | Octopus Deploy URL | octopus tools |
OCTOPUS_API_KEY | Octopus Deploy API key | octopus tools |
SOLARWINDS_API_URL | SolarWinds SWIS URL | solarwinds tools |
SOLARWINDS_USERNAME | SolarWinds username | solarwinds tools |
SOLARWINDS_PASSWORD | SolarWinds password | solarwinds tools |
VERACODE_API_ID | Veracode API ID | veracode tools |
VERACODE_API_KEY | Veracode API Key | veracode tools |
SWAGGER_HUB_API_KEY | SwaggerHub API key | swagger-hub tools |
PORT | HTTP server port (default: 3100) | Optional |
HOST | HTTP 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
| Command | Description |
|---|---|
bun run dev | stdio mode with hot reload (for MCP clients) |
bun run dev:http | HTTP mode with hot reload (for web/API access) |
bun run start | stdio mode (production) |
bun run start:http | HTTP mode (production) |
bun run build | Build to dist/ |
Built-in Tools (62 total)
Core
| Category | Tool | Description |
|---|---|---|
| web | webSearch | Search the web via Google Custom Search |
| web | webFetch | Fetch and extract content from URLs |
| file-ops | fileRead | Read file contents |
| file-ops | fileWrite | Write content to files |
| file-ops | fileList | List directory contents |
| database | dbQuery | Execute PostgreSQL queries (with safety guards) |
| database | mysqlQuery | Execute MySQL queries |
| code-helpers | shellExec | Run shell commands (blocks dangerous patterns) |
| code-helpers | gitHelper | Git status, log, diff, branch, stash |
| agents | agentCreate | Create a new AI agent with custom config |
| agents | agentList | List all registered agents |
| agents | agentRun | Send a task to an agent |
| agents | agentDelete | Remove a registered agent |
Utility
| Category | Tool | Description |
|---|---|---|
| utility | getWeatherForecast | Weather forecast (US, via NWS API) |
| utility | getCurrentTime | Get time in any timezone |
| utility | convertTime | Convert time between timezones |
| utility | locationToCoords | Geocoding/reverse geocoding via Nominatim |
Observability & Monitoring
| Category | Tool | Description |
|---|---|---|
| datadog | datadogQueryMetrics | Query Datadog metrics time series |
| datadog | datadogListMonitors | List Datadog monitors |
| datadog | datadogSearchHosts | Search Datadog infrastructure hosts |
| newrelic | newrelicNrqlQuery | Execute NRQL queries |
| newrelic | newrelicListEntities | Search New Relic entities |
| newrelic | newrelicGetEntity | Get entity details |
| pagerduty | pagerdutyListIncidents | List PagerDuty incidents |
| pagerduty | pagerdutyGetIncident | Get incident details |
| pagerduty | pagerdutyListServices | List PagerDuty services |
| splunk | splunkSearch | Execute Splunk SPL queries |
| splunk | splunkListIndexes | List Splunk indexes |
| solarwinds | solarwindsQuery | Execute SWIS queries |
| solarwinds | solarwindsGetAlerts | Get SolarWinds active alerts |
DevOps & CI/CD
| Category | Tool | Description |
|---|---|---|
| github | githubGetRepo | Get repository info |
| github | githubListPRs | List pull requests |
| github | githubListIssues | List issues |
| github | githubSearchCode | Search code across repos |
| jenkins | jenkinsListBuilds | List recent builds |
| jenkins | jenkinsGetBuild | Get build details |
| jenkins | jenkinsTriggerBuild | Trigger a build |
| octopus | octopusListProjects | List Octopus Deploy projects |
| octopus | octopusGetDeployments | Get deployments |
| octopus | octopusGetProcess | Get deployment process steps |
| launchdarkly | launchdarklyListFlags | List feature flags |
| launchdarkly | launchdarklyGetFlag | Get flag details & targeting |
Security & Quality
| Category | Tool | Description |
|---|---|---|
| sonar | sonarAnalyzeProject | Get SonarQube quality metrics |
| sonar | sonarGetIssues | Get SonarQube issues |
| veracode | veracodeListApps | List Veracode applications |
| veracode | veracodeGetScan | Get scan findings |
Collaboration & APIs
| Category | Tool | Description |
|---|---|---|
| slack | slackSendMessage | Send Slack messages |
| slack | slackListChannels | List Slack channels |
| slack | slackSearchMessages | Search Slack messages |
| salesforce | salesforceQuery | Execute SOQL queries |
| salesforce | salesforceGetObject | Get Salesforce records |
| swagger-hub | swaggerhubSearch | Search OpenAPI specs |
| swagger-hub | swaggerhubGetSpec | Get API specifications |
Data Warehouses
| Category | Tool | Description |
|---|---|---|
| snowflake | snowflakeQuery | Execute Snowflake SQL queries |
Productivity
| Category | Tool | Description |
|---|---|---|
| knowledge-graph | knowledgeGraphAddNode | Add entities to persistent graph |
| knowledge-graph | knowledgeGraphAddEdge | Add relationships |
| knowledge-graph | knowledgeGraphSearch | Search the knowledge graph |
| knowledge-graph | knowledgeGraphAddObservation | Add observations to entities |
| tasks | tasksCreate | Create tasks |
| tasks | tasksUpdate | Update task status/priority |
| tasks | tasksList | List/filter tasks |
| tasks | tasksDelete | Delete 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— Implementationsrc/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:
| ID | Name | Description |
|---|---|---|
code-security | Code Security Review | OWASP-style security analysis |
code-performance | Code Performance Analysis | Performance issue detection |
code-smell | Code Smell Detection | Refactoring suggestions |
class-diagram | Generate Class Diagram | Mermaid class diagrams from code |
flowchart | Generate Flowchart | Mermaid flowcharts from logic |
test-plan | Generate Test Plan | Comprehensive 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
| Problem | Solution |
|---|---|
bun: command not found | Restart terminal after installing Bun, or add ~/.bun/bin to PATH |
| Server won't start | Check bun install completed successfully |
| Tools not showing in client | Ensure the path in mcp.json/claude config is absolute and correct |
SEARCH_API_KEY not set | Add keys to .env file |
Cannot find module | Run bun install again |
| Port already in use | Change 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