{"id":29690980,"url":"https://github.com/aicayzer/bigquery-mcp","last_synced_at":"2026-05-08T15:01:47.462Z","repository":{"id":305231313,"uuid":"1014445531","full_name":"aicayzer/bigquery-mcp","owner":"aicayzer","description":"A Model Context Protocol (MCP) server for secure BigQuery access across multiple Google Cloud projects with advanced analytics, security controls, and Docker support.","archived":false,"fork":false,"pushed_at":"2025-07-18T23:16:06.000Z","size":1068,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-19T02:12:32.781Z","etag":null,"topics":["ai","bigquery","bigquery-api","claude","cursor","gcloud","gcloud-sdk","gcp","google-cloud-platform","mcp","mcp-server"],"latest_commit_sha":null,"homepage":"https://aicayzer.github.io/bigquery-mcp/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aicayzer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-05T18:34:28.000Z","updated_at":"2025-07-18T23:16:10.000Z","dependencies_parsed_at":"2025-07-19T02:24:30.535Z","dependency_job_id":null,"html_url":"https://github.com/aicayzer/bigquery-mcp","commit_stats":null,"previous_names":["aicayzer/bigquery-mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/aicayzer/bigquery-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicayzer%2Fbigquery-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicayzer%2Fbigquery-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicayzer%2Fbigquery-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicayzer%2Fbigquery-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aicayzer","download_url":"https://codeload.github.com/aicayzer/bigquery-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aicayzer%2Fbigquery-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266633042,"owners_count":23959465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","bigquery","bigquery-api","claude","cursor","gcloud","gcloud-sdk","gcp","google-cloud-platform","mcp","mcp-server"],"created_at":"2025-07-23T07:01:00.249Z","updated_at":"2026-05-08T15:01:42.424Z","avatar_url":"https://github.com/aicayzer.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BigQuery MCP Server\n\nMCP server for secure BigQuery access across multiple Google Cloud projects.\n\n## Features\n\n- **Multi-Project Access** - Query across BigQuery projects with pattern matching\n- **Advanced Analytics** - Column analysis, data quality checks, schema exploration\n- **Security Controls** - SQL validation, query limits, read-only operations\n- **CLI Configuration** - Command-line arguments with config file fallback\n- **Docker Support** - Containerized deployment for easy integration\n\n## Documentation\n\nFull documentation available at [aicayzer.github.io/bigquery-mcp](https://aicayzer.github.io/bigquery-mcp/)\n\n## Quick Start\n\n### Prerequisites\n- Python 3.11+\n- Google Cloud SDK\n- Docker (optional)\n\n### Authentication\n```bash\ngcloud auth application-default login\n```\n\n### Installation\n```bash\ngit clone https://github.com/aicayzer/bigquery-mcp.git\ncd bigquery-mcp\npip install -r requirements.txt\n```\n\n## MCP Client Setup\n\n### Claude Desktop\nAdd to `~/.config/claude/claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"bigquery\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"--rm\", \"-i\",\n        \"--volume\", \"/Users/YOUR_USERNAME/.config/gcloud:/home/mcpuser/.config/gcloud:ro\",\n        \"--volume\", \"/ABSOLUTE/PATH/TO/bigquery-mcp/logs:/app/logs\",\n        \"bigquery-mcp:latest\",\n        \"python\", \"src/server.py\",\n        \"--project\", \"your-project:*\",\n        \"--billing-project\", \"your-project\"\n      ]\n    }\n  }\n}\n```\n\n### Cursor IDE\nAdd to MCP settings:\n```json\n{\n  \"bigquery\": {\n    \"command\": \"docker\",\n    \"args\": [\n      \"run\", \"--rm\", \"-i\",\n      \"--volume\", \"/Users/YOUR_USERNAME/.config/gcloud:/home/mcpuser/.config/gcloud:ro\",\n      \"bigquery-mcp:latest\",\n      \"python\", \"src/server.py\",\n      \"--project\", \"your-project:*\",\n      \"--billing-project\", \"your-project\"\n    ]\n  }\n}\n```\n\n## Usage\n\n### CLI\n```bash\n# Single project\npython src/server.py --project \"your-project:*\" --billing-project \"your-project\"\n\n# Multiple projects with patterns\npython src/server.py \\\n  --project \"analytics-prod:user_*,session_*\" \\\n  --project \"logs-prod:application_*\" \\\n  --billing-project \"my-billing-project\"\n```\n\n### Docker\n```bash\ndocker build -t bigquery-mcp .\ndocker run -v ~/.config/gcloud:/home/mcpuser/.config/gcloud:ro bigquery-mcp \\\n  python src/server.py --project \"your-project:*\" --billing-project \"your-project\"\n```\n\n## Tools\n\n- **`list_projects()`** - List configured BigQuery projects\n- **`list_datasets(project)`** - List datasets in a project  \n- **`list_tables(dataset, table_type)`** - List tables in a dataset\n- **`analyze_table(table)`** - Get table structure and statistics\n- **`analyze_columns(table, columns, sample_size)`** - Deep column analysis\n- **`execute_query(query, format, limit, timeout)`** - Execute SELECT queries\n\n## Configuration\n\n### CLI Arguments\n```bash\npython src/server.py \\\n  --project \"analytics-prod:user_*,session_*\" \\\n  --project \"logs-prod:application_*\" \\\n  --billing-project \"my-billing-project\" \\\n  --log-level INFO \\\n  --timeout 20 \\\n  --max-limit 50000\n```\n\n### Config File (Optional)\n```yaml\nbigquery:\n  billing_project: \"your-project\"\n  location: \"EU\"\n\nprojects:\n  - project_id: \"analytics-prod\"\n    datasets: [\"user_*\", \"session_*\"]\n  - project_id: \"logs-prod\"  \n    datasets: [\"application_*\"]\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch from `develop`\n3. Make your changes with tests\n4. Submit a pull request to `develop`\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faicayzer%2Fbigquery-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faicayzer%2Fbigquery-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faicayzer%2Fbigquery-mcp/lists"}