{"id":27733440,"url":"https://github.com/dave-wind/mysql-mcp-server","last_synced_at":"2025-04-28T12:43:23.309Z","repository":{"id":290122905,"uuid":"973437301","full_name":"dave-wind/mysql-mcp-server","owner":"dave-wind","description":"mcp model-context-protocol mysql cursor n8n","archived":false,"fork":false,"pushed_at":"2025-04-27T02:06:45.000Z","size":0,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-27T02:31:50.691Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/dave-wind.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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-04-27T01:43:09.000Z","updated_at":"2025-04-27T02:07:17.000Z","dependencies_parsed_at":"2025-04-27T02:31:52.511Z","dependency_job_id":"f3c39cbb-2dff-465c-b17a-b9bc18e7d622","html_url":"https://github.com/dave-wind/mysql-mcp-server","commit_stats":null,"previous_names":["dave-wind/mysql-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-wind%2Fmysql-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-wind%2Fmysql-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-wind%2Fmysql-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dave-wind%2Fmysql-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dave-wind","download_url":"https://codeload.github.com/dave-wind/mysql-mcp-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251315618,"owners_count":21569839,"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","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":[],"created_at":"2025-04-28T12:43:22.386Z","updated_at":"2025-04-28T12:43:23.303Z","avatar_url":"https://github.com/dave-wind.png","language":"JavaScript","funding_links":[],"categories":["Database \u0026 Messaging MCP Servers","پیاده‌سازی‌های سرور","🗄️ Database","APIs and HTTP Requests","Databases","Server Implementations"],"sub_categories":["🗄️ \u003ca name=\"databases\"\u003e\u003c/a\u003eپایگاه‌های داده","How to Submit","🗄️ \u003ca name=\"databases\"\u003e\u003c/a\u003eDatabases"],"readme":"# @davewind/mysql-mcp-server\n\n\nA Model Context Protocol server that provides read-only access to Mysql databases. This server enables LLMs to inspect database schemas and execute read-only queries.\n\n### Key Features\n1.Read-Only Database Access: Enforces read-only operations through SQL validation and READ ONLY transactions  \n2.Schema Discovery: Automatically identifies and exposes database table structures  \n3.SQL Query Execution: Provides a query tool that accepts and executes SELECT statements  \n4.Model Context Protocol Compliance: Implements the MCP specification for seamless integration with compatible LLMs  \n5.Simple Configuration: Easy setup with minimal configuration required  \n\n\n### Tools\n\n- **query**\n  - Execute read-only SQL queries against the connected database\n  - Input: `sql` (string): The SQL query to execute\n  - All queries are executed within a READ ONLY transaction\n\n### Resources\n\nThe server provides schema information for each table in the database:\n\n- **Table Schemas** (`mysql://user:password@localhost:3306/database`)\n  - JSON schema information for each table\n  - Includes column names and data types\n  - Automatically discovered from database metadata\n\n\n### Install\n```bash\nnpm install @davewind/mysql-mcp-server -g\n```\n\n## Configuration\nMCP settings configuration file:\n\n\u003e recommended use\n\n```json\n{\n  \"mcpServers\": {\n    \"mysql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@davewind/mysql-mcp-server\", \"mysql://user:password@localhost:port/database\"],\n    }\n  }\n}\n```\n\n\n\n### Test\n\u003e  Replace mysql://user:password@localhost:port/  and npm run inspector\n```js\n  \"scripts\": {\n    \"inspector\": \"npx @modelcontextprotocol/inspector@0.10.2 build/index.js mysql://user:password@localhost:port/database\n  }\n```\n\n\n### Env\n\n```js\n\nnode v18 +\n\n```\n\n### System Architecture\n\u003e The MySQL MCP Server acts as an intermediary between LLMs and MySQL databases, processing requests according to the Model Context Protocol.\n\u003cp\u003e\n  \u003cimg src=\"./docs/High-Level Architecture.png\" alt=\"\"/\u003e\n\u003c/p\u003e\n\n\n### Component Interaction\n\u003cp\u003e\n  \u003cimg src=\"./docs/component-Interaction.png\" alt=\"\"/\u003e\n\u003c/p\u003e\n\n\n### Component Interaction\n\u003cp\u003e\n  \u003cimg src=\"./docs/component-Interaction.png\" alt=\"\"/\u003e\n\u003c/p\u003e\n\n### Security Model\n\u003e The MySQL MCP Server implements a strict security model to ensure that database access is read-only.\n\u003cp\u003e\n  \u003cimg src=\"./docs/Security Model.png\" alt=\"\"/\u003e\n\u003c/p\u003e\n\nSecurity measures include:\n\n1.SQL query validation to allow only SELECT statements\n2.Execution of all queries within READ ONLY transactions\n3.No support for data modification operations (INSERT, UPDATE, DELETE, etc.)\n4. No support for database schema modification (CREATE, ALTER, DROP, etc.)\n\n\n### Integration with LLMs\n\u003e The MySQL MCP Server is designed to work with any LLM system that supports the Model Context Protocol. It communicates through JSON-RPC over stdio, following the MCP specification.\n\u003cp\u003e\n  \u003cimg src=\"./docs/Integration with LLMs.png\" alt=\"\"/\u003e\n\u003c/p\u003e\n\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdave-wind%2Fmysql-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdave-wind%2Fmysql-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdave-wind%2Fmysql-mcp-server/lists"}