brev-mcp/README.md at main · brevdev/brev-mcp · GitHub

Skip to content

Navigation Menu

Toggle navigation

Sign in

• Product

  • GitHub Copilot Write better code with AI
  • Security Find and fix vulnerabilities
  • Actions Automate any workflow
  • Codespaces Instant dev environments
  • Issues Plan and track work
  • Code Review Manage code changes
  • Discussions Collaborate outside of code
  • Code Search Find more, search less

  Explore

  • All features
  • Documentation
  • GitHub Skills
  • Blog

• Solutions

  By company size

  • Enterprises
  • Small and medium teams
  • Startups
  • Nonprofits

  By use case

  • DevSecOps
  • DevOps
  • CI/CD
  • View all use cases

  By industry

  • Healthcare
  • Financial services
  • Manufacturing
  • Government
  • View all industries

  View all solutions

• Resources

  Topics

  • AI
  • DevOps
  • Security
  • Software Development
  • View all

  Explore

  • Learning Pathways
  • Events & Webinars
  • Ebooks & Whitepapers
  • Customer Stories
  • Partners
  • Executive Insights

• Open Source

  • GitHub Sponsors Fund open source developers

  • The ReadME Project GitHub community articles

  Repositories

  • Topics
  • Trending
  • Collections

• Enterprise

  • Enterprise platform AI-powered developer platform

  Available add-ons

  • Advanced Security Enterprise-grade security features
  • Copilot for business Enterprise-grade AI features
  • Premium Support Enterprise-grade 24/7 support

• Pricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel Create saved search

Sign in

Sign up Reseting focus

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

{{ message }}

brevdev / brev-mcp Public

• Notifications You must be signed in to change notification settings

• Fork 2

• Star 3

• Code

• Issues 0

• Pull requests 2

• Actions

• Projects 0

• Security

• Insights

Additional navigation options

• Code
• Issues
• Pull requests
• Actions
• Projects
• Security
• Insights

Files

main

• src

• tests

• .gitignore

• .python-version

• README.md

• pyproject.toml

• uv.lock

Breadcrumbs

1. brev-mcp

/

README.md

Copy path

Blame

Blame

Latest commit

tmonty12

update README

Dec 9, 2024

88bf6ce · Dec 9, 2024

History

History

90 lines (59 loc) · 2.24 KB

Breadcrumbs

1. brev-mcp

/

README.md

Top

File metadata and controls

• Preview

• Code

• Blame

90 lines (59 loc) · 2.24 KB

Raw

Brev MCP server

This is a MCP server implementation for Brev.

Configuration

The MCP server uses the Brev CLI's API access token and currently set org.

Follow the Brev documentation to download the CLI and login if you haven't already.

If you want to switch your Brev org, run brev set <org-name>

The CLI access token expires every hour. If you have any 403 errors, simply run brev ls to refresh the access token.

Quickstart

Setup repository locally

git clone git@github.com:brevdev/brev-mcp.git

Install uv

Follow the uv installation guide

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the following to your claude_desktop_config.json:

Development/Unpublished Servers Configuration

"mcpServers": {
  "brev_mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "<path-to-repo>",
      "run",
      "brev-mcp"
    ]
  }
}

Development

Building and Publishing

To prepare the package for distribution:

1. Sync dependencies and update lockfile:

uv sync

2. Build package distributions:

uv build

This will create source and wheel distributions in the dist/ directory.

3. Publish to PyPI:

uv publish

Note: You'll need to set PyPI credentials via environment variables or command flags:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /Users/tmontfort/Brev/repos/brev_mcp run brev-mcp

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Footer

© 2025 GitHub, Inc.

Footer navigation

• Terms
• Privacy
• Security
• Status
• Docs
• Contact
• Manage cookies
• Do not share my personal information

You can’t perform that action at this time.