{"id":30871768,"url":"https://github.com/googleapis/mcp-toolbox-sdk-go","last_synced_at":"2025-10-09T20:25:20.993Z","repository":{"id":302116344,"uuid":"982469285","full_name":"googleapis/mcp-toolbox-sdk-go","owner":"googleapis","description":"Go SDK for interacting with the MCP Toolbox for Databases.","archived":false,"fork":false,"pushed_at":"2025-09-30T08:38:11.000Z","size":162,"stargazers_count":23,"open_issues_count":3,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-30T10:26:42.695Z","etag":null,"topics":["databases","genai-go","genkit-go","go","golang","langchain","llms","mcp","mcp-client"],"latest_commit_sha":null,"homepage":"https://googleapis.github.io/genai-toolbox/getting-started/introduction/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/googleapis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-12T23:55:03.000Z","updated_at":"2025-09-30T08:38:15.000Z","dependencies_parsed_at":"2025-07-16T16:05:49.180Z","dependency_job_id":"da7305cc-c63a-4e65-9425-b94797852e84","html_url":"https://github.com/googleapis/mcp-toolbox-sdk-go","commit_stats":null,"previous_names":["googleapis/mcp-toolbox-sdk-go"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/googleapis/mcp-toolbox-sdk-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fmcp-toolbox-sdk-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fmcp-toolbox-sdk-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fmcp-toolbox-sdk-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fmcp-toolbox-sdk-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/googleapis","download_url":"https://codeload.github.com/googleapis/mcp-toolbox-sdk-go/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fmcp-toolbox-sdk-go/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002013,"owners_count":26083258,"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-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["databases","genai-go","genkit-go","go","golang","langchain","llms","mcp","mcp-client"],"created_at":"2025-09-07T22:05:28.880Z","updated_at":"2025-10-09T20:25:20.988Z","avatar_url":"https://github.com/googleapis.png","language":"Go","funding_links":[],"categories":["⚙️ DevOps","📚 Projects (2474 total)"],"sub_categories":["MCP Servers"],"readme":"![MCP Toolbox\nLogo](https://raw.githubusercontent.com/googleapis/genai-toolbox/main/logo.png)\n\n# MCP Toolbox SDKs for Go\n\n[![License: Apache\n2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Docs](https://img.shields.io/badge/Docs-MCP_Toolbox-blue)](https://googleapis.github.io/genai-toolbox/)\n[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=flat\u0026logo=discord\u0026logoColor=white)](https://discord.gg/Dmm69peqjh)\n[![Medium](https://img.shields.io/badge/Medium-12100E?style=flat\u0026logo=medium\u0026logoColor=white)](https://medium.com/@mcp_toolbox)\n[![Go Report Card](https://goreportcard.com/badge/github.com/googleapis/mcp-toolbox-sdk-go)](https://goreportcard.com/report/github.com/googleapis/mcp-toolbox-sdk-go)\n[![Module Version](https://img.shields.io/github/v/release/googleapis/mcp-toolbox-sdk-go)](https://img.shields.io/github/v/release/googleapis/mcp-toolbox-sdk-go)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/googleapis/mcp-toolbox-sdk-go)](https://img.shields.io/github/go-mod/go-version/googleapis/mcp-toolbox-sdk-go)\n\nThis repository contains the Go SDK designed to seamlessly integrate the\nfunctionalities of the [MCP\nToolbox](https://github.com/googleapis/genai-toolbox) into your Gen AI\napplications. The SDK allow you to load tools defined in Toolbox and use them\nas standard Go tools within popular orchestration frameworks\nor your custom code.\n\nThis simplifies the process of incorporating external functionalities (like\nDatabases or APIs) managed by Toolbox into your GenAI applications.\n\n\u003c!-- TOC --\u003e\n\n- [Overview](#overview)\n- [Which Package Should I Use?](#which-package-should-i-use)\n- [Available Packages](#available-packages)\n- [Getting Started](#getting-started)\n- [Contributing](#contributing)\n- [License](#license)\n- [Support](#support)\n\n\u003c!-- /TOC --\u003e\n\n## Overview\n\nThe MCP Toolbox service provides a centralized way to manage and expose tools\n(like API connectors, database query tools, etc.) for use by GenAI applications.\n\nThe Go SDK act as clients for that service. They handle the communication needed to:\n\n* Fetch tool definitions from your running Toolbox instance.\n* Provide convenient Go structs representing those tools.\n* Invoke the tools (calling the underlying APIs/services configured in Toolbox).\n* Handle authentication and parameter binding as needed.\n\nBy using the SDK, you can easily leverage your Toolbox-managed tools directly\nwithin your Go applications or AI orchestration frameworks.\n\n## Which Package Should I Use?\n\nChoosing the right package depends on how you are building your application:\n\n- [`core`](https://github.com/googleapis/mcp-toolbox-sdk-go/tree/main/core):\n  This is a framework agnostic way to connect the tools to popular frameworks\n  like Google GenAI, LangChain, etc.\n\n- [`tbgenkit`](https://github.com/googleapis/mcp-toolbox-sdk-go/tree/main/tbgenkit):\n  This package provides a functionality to convert the Tool fetched using the core package\n  into a Genkit Go compatible tool.\n\n## Available Packages\n\nThis repository hosts the following Go packages. See the package-specific\nREADME for detailed installation and usage instructions:\n\n| Package | Target Use Case | Integration | Path | Details (README) |\n| :------ | :----------| :---------- | :---------------------- | :---------- |\n| `core` | Framework-agnostic / Custom applications | Use directly / Custom | `core/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/core/README.md) |\n| `tbgenkit` | Genkit Go | Along with core | `tbgenkit/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/tbgenkit/README.md) |\n\n## Getting Started\n\nTo get started using Toolbox tools with an application, follow these general steps:\n\n1. **Set up and Run the Toolbox Service:**\n\n    Before using the SDKs, you need the MCP Toolbox server running. Follow\n    the instructions here: [**Toolbox Getting Started\n    Guide**](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started)\n\n2. **Install the Appropriate SDK:**\n\n    Choose the package based on your needs (see \"[Which Package Should I Use?](#which-package-should-i-use)\" above)\n    Use this command to install the SDK module\n\n    ```bash\n    # For the core, framework-agnostic SDK\n    go get github.com/googleapis/mcp-toolbox-sdk-go\n    ```\n\n3. **Use the SDK:**\n\n    Consult the README for your chosen package (linked in the \"[Available\n    Packages](#available-packages)\" section above) for detailed instructions on\n    how to connect the client, load tool definitions, invoke tools, configure\n    authentication/binding, and integrate them into your application or\n    framework.\n\n## Contributing\n\nContributions are welcome! Please refer to the\n[`CONTRIBUTING.md`](https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/CONTRIBUTING.md)\nto get started.\n\n## License\n\nThis project is licensed under the Apache License 2.0. See the\n[LICENSE](https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/LICENSE) file\nfor details.\n\n## Support\n\nIf you encounter issues or have questions, please check the existing [GitHub\nIssues](https://github.com/googleapis/genai-toolbox/issues) for the main Toolbox\nproject. If your issue is specific to one of the SDKs, please look for existing\nissues [here](https://github.com/googleapis/mcp-toolbox-sdk-go/issues) or\nopen a new issue in this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleapis%2Fmcp-toolbox-sdk-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogleapis%2Fmcp-toolbox-sdk-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleapis%2Fmcp-toolbox-sdk-go/lists"}