{"id":29267656,"url":"https://github.com/myxvisual/mermaid-mcp-server","last_synced_at":"2025-10-06T02:10:52.231Z","repository":{"id":300058706,"uuid":"1005077833","full_name":"myxvisual/mermaid-mcp-server","owner":"myxvisual","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-19T17:01:12.000Z","size":102,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-19T17:43:10.639Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/myxvisual.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-06-19T16:20:47.000Z","updated_at":"2025-06-19T17:01:15.000Z","dependencies_parsed_at":"2025-06-19T17:43:36.395Z","dependency_job_id":"e2316ce3-dd9c-4e0c-b1a4-59481de37547","html_url":"https://github.com/myxvisual/mermaid-mcp-server","commit_stats":null,"previous_names":["myxvisual/mermaid-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/myxvisual/mermaid-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myxvisual%2Fmermaid-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myxvisual%2Fmermaid-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myxvisual%2Fmermaid-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myxvisual%2Fmermaid-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/myxvisual","download_url":"https://codeload.github.com/myxvisual/mermaid-mcp-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myxvisual%2Fmermaid-mcp-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263594623,"owners_count":23485877,"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-07-04T18:11:18.221Z","updated_at":"2025-10-06T02:10:47.199Z","avatar_url":"https://github.com/myxvisual.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧜‍♀️ mermaid-mcp-server\n\nA simple and robust MCP server providing live information about Mermaid.js diagrams.\n\nThis is a TypeScript-based [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) server that provides access to Mermaid diagram information. It exposes a set of tools to discover and retrieve details about the various diagram types supported by Mermaid.\n\n## 🚀 How It Works\n\nA client can connect to this server and use the provided tools to query information. For example, a client might first list all available diagrams and then request specific details or examples for one of them.\n\nHere is a mindmap summarizing the server's purpose, tools, and a typical interaction flow:\n\n```mermaid\nmindmap\n  root((🧜‍♀️ mermaid-mcp-server))\n    ::icon(fa fa-server)\n    Core Purpose\n      ::icon(fa fa-bullseye)\n      Provide Mermaid.js Info\n      Uses Model Context Protocol (MCP)\n    Available Tools\n      ::icon(fa fa-toolbox)\n      about\n      list_diagrams\n      get_diagram\n      get_diagram_examples\n    Client Interaction Flow\n      ::icon(fa fa-cogs)\n      1. Connect to Server\n      2. Query with Tools\n        Discover diagrams \u003cbr/\u003e (list_diagrams)\n        Fetch details \u003cbr/\u003e (get_diagram)\n        Get examples \u003cbr/\u003e (get_diagram_examples)\n    Technology\n      ::icon(fa fa-code)\n      TypeScript\n      Node.js\n```\n\n## 📦 Configuring with Claude\nTo use an MCP server with Claude, add it to your configuration:\n```json\n{\n    \"mcpServers\": {\n        \"mermaid-mcp-server\": {\n            \"command\": \"npx\",\n            \"args\": [\n                \"-y\",\n                \"mermaid-mcp-server\",\n            ]\n        }\n    }\n}\n```\n\n## 🛠️ Tools\n\nThe server exposes the following tools via MCP:\n\n| Tool Name              | Description                                                          | Parameters                                                              |\n| ---------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------- |\n| `about`                | Provides a general description of the Mermaid project.               | _None_                                                                  |\n| `list_diagrams`        | Lists all available Mermaid diagram types.                           | _None_                                                                  |\n| `get_diagram`          | Gets detailed information about a specific diagram type.             | `diagramType: string` \u003cbr/\u003e (e.g., \"flowchart\", \"sequenceDiagram\")      |\n| `get_diagram_examples` | Gets one or more syntax examples for a specific diagram type.        | `diagramType: string` \u003cbr/\u003e (e.g., \"flowchart\", \"sequenceDiagram\")      |\n\n## 💻 Development\n\nTo get started with development, follow these steps:\n\n1.  **Clone the repository:**\n    ```bash\n    git clone https://github.com/myxvisual/mermaid-mcp-server\n    cd mermaid-mcp-server\n    ```\n\n2.  **Install dependencies:**\n    ```bash\n    npm install\n    ```\n\n3.  **Build for production:**\n    ```bash\n    npm run build\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmyxvisual%2Fmermaid-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmyxvisual%2Fmermaid-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmyxvisual%2Fmermaid-mcp-server/lists"}