Skip to content

arvoreeducacao/arvore-mcp-servers

BranchesTags

Repository files navigation

Arvore MCP Servers

A collection of Model Context Protocol (MCP) servers developed by Arvore for seamless integration with AI assistants like Claude.

CI License: MIT

📦 Packages

This monorepo contains the following MCP servers:

@arvoretech/aws-secrets-manager-mcp

Manage AWS Secrets Manager secrets directly from your AI assistant.

Features:

  • Create, read, update, and delete secrets
  • List all secrets in your account
  • Describe secret metadata

@arvoretech/datadog-mcp

Query and analyze Datadog monitoring data.

Features:

  • Query metrics and time series data
  • Search logs
  • Get service maps and APM data
  • List hosts and active metrics
  • Search traces

@arvoretech/mysql-mcp

Execute read-only MySQL queries safely.

Features:

  • Execute SELECT queries
  • List tables in database
  • Read-only operations for safety

@arvoretech/postgresql-mcp

Execute read-only PostgreSQL queries safely.

Features:

  • Execute SELECT queries
  • List tables, schemas, and databases
  • Describe table structure
  • Full schema support
  • Read-only operations for safety

@arvoretech/clickhouse-mcp

Execute read-only ClickHouse queries safely.

Features:

  • Execute SELECT queries
  • List tables and databases
  • Describe table structure (columns, types, keys)
  • Read-only operations for safety

@arvoretech/npm-registry-mcp

Search and get information about npm packages.

Features:

  • Get package information and metadata
  • Get download statistics
  • Search packages by query

@arvoretech/launchdarkly-mcp

Manage LaunchDarkly feature flags directly from your AI assistant.

Features:

  • List, search, create, and delete feature flags
  • Toggle flags ON/OFF per environment
  • Add targeting rules (in, contains, segmentMatch, etc.)
  • List and inspect segments
  • Multi-environment support (production, test, etc.)

@arvoretech/tempmail-mcp

Self-hosted temporary email server with SMTP + SQLite.

Features:

  • Built-in SMTP server to receive real emails
  • Create and manage temporary email accounts
  • Read, list, and delete emails
  • SQLite storage — no third-party dependencies
  • Configurable domain via AWS Route 53

@arvoretech/google-chat-mcp

Google Chat integration for managing spaces, members, and messages.

Features:

  • List and inspect Google Chat spaces
  • List space members
  • Read message history with filtering and pagination
  • Send messages (with thread support)
  • Delete messages
  • Service account JWT auth (no external dependencies)
  • Domain-wide delegation for full user-level access

@arvoretech/gmail-mcp

Gmail integration — read, send, and manage messages with OAuth user flow.

Features:

  • Search messages with full Gmail query syntax (from:, is:unread, newer_than:, etc.)
  • Read messages and full threads with parsed headers and body
  • Create drafts (always available, even with sending disabled)
  • Send mail and reply with proper threading (In-Reply-To, References, threadId)
  • Modify labels (mark read, archive, star, trash)
  • OAuth Desktop client flow with browser-based login
  • Encrypted token storage (AES-256-GCM + macOS keychain)
  • Send-mode opt-in via GMAIL_MCP_ALLOW_SEND to prevent accidental sends

@arvoretech/memory-mcp

Team memory — persistent knowledge base with semantic search for AI-assisted development.

Features:

  • Semantic search across team memories using local embeddings
  • Multilingual support (Portuguese + English) via paraphrase-multilingual-MiniLM-L12-v2
  • Categories: decisions, conventions, incidents, domain, gotchas
  • Create, archive, and remove memories via MCP tools
  • Embedding cache for fast startup
  • Keyword fallback when embeddings are unavailable

@arvoretech/runtime-lens-mcp

Runtime Lens — Runtime inspection with inline values for React, NestJS and Next.js. Two components in one package: a VS Code/Cursor/Kiro extension with inline value display and an MCP server for AI-assisted debugging.

Features:

  • Inline runtime values displayed in the editor
  • Runtime agent injected via --require that patches console.log/warn/error/debug
  • WebSocket-based communication between agent and extension
  • 14 MCP tools for AI-assisted debugging: log tailing, regex search, error inspection, HTTP request inspection, performance metrics, and more
  • Framework detection for React, NestJS, and Next.js
  • Real-time console capture with start/stop control
  • Permanent setup via ~/.zshrc — no need to inject every session

@arvoretech/meet-transcriptions-mcp

Semantic search across meeting transcriptions generated by Meet Transcriber.

Features:

  • Semantic search using local multilingual embeddings (paraphrase-multilingual-MiniLM-L12-v2)
  • LanceDB vector store with keyword fallback
  • Filter by speaker
  • List and retrieve full transcription content
  • Reads .md files from ~/Documents/meet-transcriptions/ by default

@arvoretech/sendgrid-mcp

Manage SendGrid Dynamic Templates directly from your AI assistant.

Features:

  • List, create, update, and delete dynamic templates
  • Create and manage template versions (HTML content, subject, plain text)
  • Activate specific template versions
  • Full CRUD for templates and versions via SendGrid API v3

@arvoretech/await-until-mcp

Polling/waiting primitives — repeatedly check conditions until they're met or time out.

Features:

  • Execute shell commands until output matches a condition
  • Poll HTTP endpoints until they return expected status/body
  • Watch filesystem until files exist, disappear, or contain content
  • Call any other MCP server's tool and poll until the result matches (auto-discovers from mcp.json)
  • Configurable interval, timeout, and match conditions

@arvoretech/mcp-proxy

MCP Proxy Gateway — consolidates N upstream MCP servers behind 2 tools.

Features:

  • Exposes only mcp_search and mcp_call to the agent
  • Semantic search using multilingual embeddings (paraphrase-multilingual-MiniLM-L12-v2)
  • Hybrid ranking: BM25 lexical + cosine similarity
  • Output shaping: strips redundant fields, truncates text, assigns short refs
  • Cursor-based pagination with TTL
  • Supports stdio and HTTP transports with env var expansion

@arvoretech/agent-teams-lead-mcp

Agent Teams Lead — spawn and coordinate multiple AI agent sessions working together as a team. Inspired by Anthropic's agent teams for Claude Code, built as an editor-agnostic MCP layer.

Features:

  • Spawn teammates as independent CLI processes (Kiro, Cursor, Claude Code, OpenCode)
  • Shared task list with dependencies and exclusive file paths
  • Inter-agent messaging (direct, broadcast, or to lead)
  • Atomic mkdir-based file locking for safe parallel task claiming
  • Audit log in .agent-teams/team.log

@arvoretech/agent-teams-teammate-mcp

Agent Teams Teammate — MCP injected into each teammate session for claiming tasks, messaging, and publishing artifacts.

Features:

  • Claim pending tasks with dependency and lock validation
  • Communicate with other teammates and the lead
  • Publish artifacts (markdown, JSON, or code) linked to tasks
  • Automatically injected by the lead — no manual configuration needed

@arvoretech/agent-teams-chat-mcp

Agent Teams Chat — cross-developer agent communication via Slack threads. Enables AI agents from different developers to communicate asynchronously through a shared Slack channel.

Features:

  • Open conversation threads in a team Slack channel
  • Reply to existing threads
  • Read thread messages and catch up on conversations
  • List recent threads with reply counts and participants
  • Search threads by topic or content
  • Configurable message format using handlebars-style templates

@arvoretech/agent-teams-ui

Agent Teams UI — TUI dashboard for monitoring agent teams in real time. Watches .agent-teams/ and auto-refreshes.

Features:

  • Team view with per-teammate task counts and current activity
  • Kanban board with task selection and detail view
  • WhatsApp-style message view with date separators and sender grouping
  • Chat view showing agent stdout as conversation, filterable by agent
  • Live timer, progress bar, and new-activity indicators per tab
  • Auto-refresh via filesystem watching (chokidar)

@arvoretech/kanban-mcp

Persistent kanban boards for AI agents — manage tasks across sessions with multi-agent coordination, semantic search, and a Linear-style web UI.

Features:

  • 12 MCP tools for board and card management
  • Multi-session: claim/release cards with session tracking across parallel chats
  • Semantic search via LanceDB with multilingual embeddings
  • Subtasks via parent_card_id
  • Optional web UI (Linear-style dark theme with drag-and-drop, hotkeys, context menus)
  • JSON persistence with atomic writes
  • Re-read from disk for multi-process visibility

@arvoretech/metabase-mcp

Interact with Metabase BI platform directly from your AI assistant.

Features:

  • CRUD for cards (questions), dashboards, and collections
  • List databases and tables
  • Execute native SQL queries
  • Run saved card queries
  • Add cards to dashboards
  • Get collection items

@arvoretech/mgc-mcp

Manage Magalu Cloud infrastructure through the MGC CLI.

Features:

  • Virtual Machines: list, create, start, stop, reboot, delete
  • Object Storage: buckets and objects management
  • Networking: VPCs, subnets, public IPs
  • Kubernetes: cluster management and kubeconfig retrieval
  • Block Storage and DBaaS instance listing
  • Semantic search across Magalu developer documentation
  • Configurable region via MGC_REGION env var

@arvoretech/arc-browser-mcp

Control Arc Browser on macOS via a hybrid AppleScript + Chrome DevTools Protocol approach.

Features:

  • Tab management: list, open, close, search, focus
  • Space management: list, get active, switch
  • Screenshots via CDP (viewport or full page)
  • Network request capture and console log monitoring
  • DOM interaction: click, hover, type, scroll, wait for selector
  • JavaScript execution (AppleScript for quick queries, CDP for async/await)
  • Cookie inspection and page content extraction

@arvoretech/posthog-mcp

PostHog analytics, feature flags, experiments, and more. Works with both PostHog Cloud and self-hosted instances.

Features:

  • HogQL queries and structured queries (Trends, Funnels, Retention, Lifecycle, Paths, Stickiness)
  • Feature flags: create, update, list, delete with rollout control
  • A/B test experiments with variants and metrics
  • Dashboards and saved insights management
  • Event and property definitions exploration
  • Persons search and cohort management
  • Surveys, early access features, and annotations
  • Cross-entity search

@arvoretech/slack-advanced-mcp

Advanced Slack integration using user tokens -- messages sent as the authenticated user.

Features:

  • Fuzzy user search with disk cache (47k+ users load instantly)
  • Smart DM: resolve user by name/email/ID, auto-open DM channel
  • Writing style analysis (emoji usage, punctuation, vocabulary, formality)
  • Thread extraction from Slack URLs with participant resolution
  • Audio transcription via ElevenLabs STT
  • Image download and base64 return for model analysis
  • Rate limit retry with backoff

@arvoretech/whatsapp-mcp

Drive a single WhatsApp account from your AI agent using Baileys.

Features:

  • Pair via QR code (ASCII in terminal, PNG file, or base64 data URL)
  • Send and receive text, images, audio (PTT or normal), video, and documents
  • Local SQLite store for chats, messages, and contacts so the agent can recall past conversations
  • Brazilian phone number normalization with WhatsApp-side validation
  • Set typing presence, mark messages as read, react, edit, and delete
  • Single connection — pair one WhatsApp account from your local agent

🚀 Quick Start

Installation

Install individual packages:

npm install -g @arvoretech/aws-secrets-manager-mcp
npm install -g @arvoretech/datadog-mcp
npm install -g @arvoretech/mysql-mcp
npm install -g @arvoretech/postgresql-mcp
npm install -g @arvoretech/clickhouse-mcp
npm install -g @arvoretech/npm-registry-mcp
npm install -g @arvoretech/launchdarkly-mcp
npm install -g @arvoretech/tempmail-mcp
npm install -g @arvoretech/google-chat-mcp
npm install -g @arvoretech/gmail-mcp
npm install -g @arvoretech/memory-mcp
npm install -g @arvoretech/runtime-lens-mcp
npm install -g @arvoretech/meet-transcriptions-mcp
npm install -g @arvoretech/sendgrid-mcp
npm install -g @arvoretech/await-until-mcp
npm install -g @arvoretech/mcp-proxy
npm install -g @arvoretech/agent-teams-lead-mcp
npm install -g @arvoretech/agent-teams-teammate-mcp
npm install -g @arvoretech/agent-teams-chat-mcp
npm install -g @arvoretech/metabase-mcp
npm install -g @arvoretech/mgc-mcp
npm install -g @arvoretech/kanban-mcp
npm install -g @arvoretech/posthog-mcp
npm install -g @arvoretech/slack-advanced-mcp
npm install -g @arvoretech/whatsapp-mcp

Or using pnpm:

pnpm add -g @arvoretech/aws-secrets-manager-mcp

Configuration

Add to your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "aws-secrets-manager": {
      "command": "npx",
      "args": ["-y", "@arvoretech/aws-secrets-manager-mcp"]
    },
    "datadog": {
      "command": "npx",
      "args": ["-y", "@arvoretech/datadog-mcp"],
      "env": {
        "DATADOG_API_KEY": "your-api-key",
        "DATADOG_APP_KEY": "your-app-key",
        "DATADOG_SITE": "datadoghq.com"
      }
    },
    "mysql": {
      "command": "npx",
      "args": ["-y", "@arvoretech/mysql-mcp"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "readonly_user",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_PORT": "3306"
      }
    },
    "postgresql": {
      "command": "npx",
      "args": ["-y", "@arvoretech/postgresql-mcp"],
      "env": {
        "POSTGRESQL_HOST": "localhost",
        "POSTGRESQL_PORT": "5432",
        "POSTGRESQL_USER": "postgres",
        "POSTGRESQL_PASSWORD": "password",
        "POSTGRESQL_DATABASE": "your_database",
        "POSTGRESQL_SSL": "false"
      }
    },
    "clickhouse": {
      "command": "npx",
      "args": ["-y", "@arvoretech/clickhouse-mcp"],
      "env": {
        "CLICKHOUSE_URL": "https://your-host:8443",
        "CLICKHOUSE_USER": "default",
        "CLICKHOUSE_PASSWORD": "secret",
        "CLICKHOUSE_DATABASE": "default"
      }
    },
    "npm-registry": {
      "command": "npx",
      "args": ["-y", "@arvoretech/npm-registry-mcp"]
    },
    "launchdarkly": {
      "command": "npx",
      "args": ["-y", "@arvoretech/launchdarkly-mcp"],
      "env": {
        "LAUNCHDARKLY_EMAIL": "your-email@example.com",
        "LAUNCHDARKLY_PASSWORD": "your-password",
        "LAUNCHDARKLY_PROJECT": "default",
        "LAUNCHDARKLY_ENVIRONMENT": "production"
      }
    },
    "tempmail": {
      "command": "npx",
      "args": ["-y", "@arvoretech/tempmail-mcp"],
      "env": {
        "CLOUDFLARE_ACCOUNT_ID": "your-account-id",
        "CLOUDFLARE_D1_DATABASE_ID": "your-database-id",
        "CLOUDFLARE_API_TOKEN": "your-api-token",
        "TEMPMAIL_DOMAIN": "yourdomain.com"
      }
    },
    "google-chat": {
      "command": "npx",
      "args": ["-y", "@arvoretech/google-chat-mcp"],
      "env": {
        "GOOGLE_CHAT_CREDENTIALS_PATH": "/path/to/service-account.json",
        "GOOGLE_CHAT_USER_EMAIL": "user@yourdomain.com"
      }
    },
    "gmail": {
      "command": "npx",
      "args": ["-y", "@arvoretech/gmail-mcp"],
      "env": {
        "GMAIL_MCP_CLIENT_ID": "your-oauth-client-id",
        "GMAIL_MCP_CLIENT_SECRET": "your-oauth-client-secret",
        "GMAIL_MCP_ALLOW_SEND": "false"
      }
    },
    "team-memory": {
      "command": "npx",
      "args": ["-y", "@arvoretech/memory-mcp"],
      "env": {
        "MEMORY_PATH": "./memories"
      }
    },
    "runtime-lens": {
      "command": "npx",
      "args": ["-y", "@arvoretech/runtime-lens-mcp"],
      "env": {
        "RUNTIME_LENS_PROJECT_ROOT": "."
      }
    },
    "meet-transcriptions": {
      "command": "npx",
      "args": ["-y", "@arvoretech/meet-transcriptions-mcp"]
    },
    "sendgrid": {
      "command": "npx",
      "args": ["-y", "@arvoretech/sendgrid-mcp"],
      "env": {
        "SENDGRID_API_KEY": "SG.your-api-key"
      }
    },
    "await-until": {
      "command": "npx",
      "args": ["-y", "@arvoretech/await-until-mcp"]
    },
    "mcp-proxy": {
      "command": "node",
      "args": ["packages/mcp-proxy/dist/index.js"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MCP_PROXY_UPSTREAMS": "[{\"name\":\"mysql\",\"command\":\"npx\",\"args\":[\"-y\",\"@arvoretech/mysql-mcp\"],\"env\":{\"MYSQL_HOST\":\"${MYSQL_HOST}\"}}]"
      }
    },
    "agent-teams-lead": {
      "command": "npx",
      "args": ["-y", "@arvoretech/agent-teams-lead-mcp"],
      "env": {
        "WORKSPACE_PATH": "/path/to/your/workspace"
      }
    },
    "agent-teams-chat": {
      "command": "npx",
      "args": ["-y", "@arvoretech/agent-teams-chat-mcp"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token",
        "SLACK_CHANNEL": "C0123456789",
        "AGENT_IDENTITY": "Your Name"
      }
    },
    "metabase": {
      "command": "npx",
      "args": ["-y", "@arvoretech/metabase-mcp"],
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        "METABASE_API_KEY": "your-api-key"
      }
    },
    "mgc": {
      "command": "npx",
      "args": ["-y", "@arvoretech/mgc-mcp"],
      "env": {
        "MGC_REGION": "br-ne1",
        "MAGALU_DOCS_DIR": "./magalu-cloud-docs"
      }
    },
    "kanban": {
      "command": "npx",
      "args": ["-y", "@arvoretech/kanban-mcp"],
      "env": {
        "KANBAN_PATH": "./kanban",
        "KANBAN_UI": "true",
        "KANBAN_PORT": "4799"
      }
    },
    "posthog": {
      "command": "npx",
      "args": ["-y", "@arvoretech/posthog-mcp"],
      "env": {
        "POSTHOG_BASE_URL": "https://posthog.example.com",
        "POSTHOG_API_KEY": "phx_your_personal_api_key"
      }
    },
    "slack-advanced": {
      "command": "npx",
      "args": ["-y", "@arvoretech/slack-advanced-mcp"],
      "env": {
        "SLACK_USER_TOKEN": "xoxp-your-user-token",
        "ELEVENLABS_API_KEY": "sk_your-elevenlabs-key"
      }
    },
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "@arvoretech/whatsapp-mcp"],
      "env": {
        "WHATSAPP_LOG_LEVEL": "warn"
      }
    }
  }
}

Note: These packages are published to the public npm registry and can be used directly with npx without any additional configuration.

🛠️ Development

Prerequisites

  • Node.js >= 20
  • pnpm >= 9

Setup

git clone https://github.com/arvoreeducacao/arvore-mcp-servers.git
cd mcp-servers
pnpm install

Build all packages

pnpm build

Run tests

pnpm test

Run tests with coverage

pnpm test:cov

Lint

pnpm lint

Development mode

Run a specific package in development mode:

cd packages/aws-secrets-manager
pnpm dev

📝 Adding a New Package

  1. Create a new directory in packages/
  2. Follow the structure of existing packages
  3. Update the root README.md
  4. Add package-specific documentation

🚢 Publishing

Automatic Publishing

This monorepo uses GitHub Actions for automatic publishing to npm. Publishing happens in these scenarios:

1. Push to main branch

All packages are automatically published when code is merged to main (after CI passes).

2. Manual workflow dispatch

You can manually trigger publishing for a specific package:

  • Go to GitHub Actions
  • Select "Publish Packages" workflow
  • Click "Run workflow"
  • Specify package name (e.g., @arvoretech/aws-secrets-manager-mcp)
  • Choose version bump type (major, minor, or patch)

Setup Requirements

To enable automatic publishing, add these secrets to your GitHub repository:

  1. NPM_TOKEN: Required for publishing to npm

  2. CODECOV_TOKEN (optional): For coverage reports

Manual Publishing

If needed, you can publish manually (requires authentication):

# Publish all packages
pnpm -r publish

# Publish specific package
cd packages/aws-secrets-manager
npm publish

Version Management

To bump versions:

# In a specific package directory
cd packages/aws-secrets-manager
pnpm version patch  # or minor, major

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

📄 License

MIT License - see the LICENSE file for details.

🔗 Links

📞 Support

For issues and questions, please open an issue on GitHub.

Made with ❤️ by Arvore Education

About

A collection of Model Context Protocol (MCP) servers developed by Arvore for seamless integration with AI assistants like Claude.

Resources

Readme

License

MIT license

Contributing

Contributing
Activity
Custom properties

Stars

8 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages