{"id":38767541,"url":"https://github.com/blues/note-mcp","last_synced_at":"2026-01-17T12:01:34.147Z","repository":{"id":302015967,"uuid":"991434406","full_name":"blues/note-mcp","owner":"blues","description":"MCP servers for Notecard, Notehub \u0026 Blues Expert","archived":false,"fork":false,"pushed_at":"2025-11-12T12:28:05.000Z","size":237,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-26T17:50:41.933Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","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/blues.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-27T16:06:50.000Z","updated_at":"2025-11-12T12:28:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"f5d92698-c191-443f-8878-94b72a6b6a37","html_url":"https://github.com/blues/note-mcp","commit_stats":null,"previous_names":["blues/note-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blues/note-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blues%2Fnote-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blues%2Fnote-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blues%2Fnote-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blues%2Fnote-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blues","download_url":"https://codeload.github.com/blues/note-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blues%2Fnote-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28508464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T11:50:55.898Z","status":"ssl_error","status_checked_at":"2026-01-17T11:50:55.569Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-17T12:01:33.366Z","updated_at":"2026-01-17T12:01:34.017Z","avatar_url":"https://github.com/blues.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# note-mcp\n\nMCP servers for Notecard, Notehub, and Blues Expert.\n\n\u003e [!WARNING]\n\u003e These MCP servers are experimental and subject to change. Please wait until a versioned release is available before relying on them.\n\n## About\n\nThis project is a collection of MCP servers for Notecard, Notehub, and Blues Expert.\n\n### Notecard (STDIO)\n\nThe Notecard MCP server is a local tool design to help you develop Notecard projects.\nIt provides a simple abstraction to Notecard (using the Notecard CLI), and can help you get started setting up and configuring your Notecards.\nThis tool provides utilities to update firmware, connect your Notecards to WiFi networks, and more.\n\n#### Prerequisites\n\n- [Notecard CLI](https://github.com/blues/notecard-cli)\n\n### Notehub (STDIO)\n\nThe Notehub MCP server is a local tool design to help you develop Notehub projects.\nIt provides a simple abstraction to Notehub (using the Notehub API), and can help you get started setting up and configuring your Notehub projects.\nThis tool provides utilities to create and manage Notehub projects, view Note events,and to manage your Notehub devices.\n\n### Blues Expert (Docker/HTTP)\n\nThe Blues Expert MCP server is a remote tool design to help you develop Notecard projects.\nWhen used with an LLM, it can help to guide with best practices, for both writing code as well as leveraging Notecard's capabilities.\nThe Blues Expert MCP provides correct and accurate information about Notecard, and can help to reduce hallucinations and errors generated by LLMs when building Notecard projects.\nUse this tool to accelerate your development process, and to ensure that your projects are built correctly and efficiently according to best practices.\n\n## Build\n\nTo build the MCP servers, you'll need to have the following tools installed:\n\n- Go (atleast v1.23)\n- Make\n\nPer MCP server, you'll need to have the following tools installed:\n\n- Notecard MCP: [Notecard CLI](https://github.com/blues/notecard-cli)\n- Notehub MCP: Notehub Account with API access\n- Blues Expert MCP: [Docker](https://www.docker.com/products/docker-desktop/)\n\nThen, run the following command:\n\n```bash\nmake build\n```\n\n## Install\n\nAdd the following to your `mcp.json` file, where `mcp.json` is the file that determines where the MCP servers are located (e.g. for Claude Desktop, this is `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"notecard\": {\n      \"type\": \"stdio\",\n      \"command\": \"/YOUR/PATH/TO/note-mcp/notecard/notecard\"\n    },\n    \"notehub\": {\n      \"type\": \"stdio\",\n      \"command\": \"/YOUR/PATH/TO/note-mcp/notehub/notehub\",\n      \"args\": [\n        \"--env\",\n        \"/YOUR/PATH/TO/note-mcp/.env\"\n      ]\n    },\n    \"blues-expert\": {\n      \"type\": \"http\",\n      \"url\": \"http://localhost:8080/expert/mcp\"\n    }\n  },\n}\n```\n\nThe `.env` file for Notehub MCP should contain the following variables:\n\n```bash\nNOTEHUB_USER=\"your_notehub_username\"\nNOTEHUB_PASS=\"your_notehub_password\"\n```\n\nAdditional variables will be added.\n\n## Development\n\nTo run the MCP inspector, you'll need nodejs installed (atleast v18).\n\nFor Notecard MCP:\n\n```bash\nmake inspect notecard\n```\n\nFor Notehub MCP:\n\n```bash\nmake inspect notehub\n```\n\nFor Blues Expert MCP:\n\n```bash\nmake inspect blues-expert\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblues%2Fnote-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblues%2Fnote-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblues%2Fnote-mcp/lists"}