{"id":37877393,"url":"https://github.com/74th/ch32v003-guidebook-mcpserver","last_synced_at":"2026-01-16T16:45:55.272Z","repository":{"id":291725544,"uuid":"978455723","full_name":"74th/ch32v003-guidebook-mcpserver","owner":"74th","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-01T09:59:28.000Z","size":1494,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-10T11:54:19.313Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/74th.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-05-06T02:40:26.000Z","updated_at":"2025-07-01T09:59:31.000Z","dependencies_parsed_at":"2025-05-06T08:44:19.208Z","dependency_job_id":"bb6ef9aa-c9e7-451d-bf27-38b77aa4584d","html_url":"https://github.com/74th/ch32v003-guidebook-mcpserver","commit_stats":null,"previous_names":["74th/ch32v003-guidebook-mcpserver"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/74th/ch32v003-guidebook-mcpserver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/74th%2Fch32v003-guidebook-mcpserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/74th%2Fch32v003-guidebook-mcpserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/74th%2Fch32v003-guidebook-mcpserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/74th%2Fch32v003-guidebook-mcpserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/74th","download_url":"https://codeload.github.com/74th/ch32v003-guidebook-mcpserver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/74th%2Fch32v003-guidebook-mcpserver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28480081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: 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-16T16:45:55.176Z","updated_at":"2026-01-16T16:45:55.253Z","avatar_url":"https://github.com/74th.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CH32V003 Guidebook MCP Server\n\n🇯🇵\nCH32V003 ガイドブック MCP サーバー\n\nThis MCP Server helps develop CH32V003 firmware using the \"CH32V003 Guidebook\" written by @74th.\n\n🇯🇵\n@74th が執筆した技術同人誌『CH32V003 Guidebook』を利用したCH32V003ファームウェア開発用のMCP Serverプログラムです。\n\n\u003cimg src=\"./docs/toppage.png\" width=\"400px\" alt=\"CH32V003 Guidebook\" /\u003e\n\nThe guidebook will be available at Gijutsushoten18 (Japan’s largest indie tech-book fair) starting May 31, 2025!\n\n🇯🇵\n技術同人誌は、2025年5月31日スタートの技術書典18にて頒布します！\n\n\u003e CH32V003開発ガイドブック — スイッチサイエンス\n\u003e\n\u003e [https://www.switch-science.com/products/10547](https://www.switch-science.com/products/10547)\n\n\u003e CH32V003開発ガイドブック[74TH-B018] - 74th Books \u0026 Gadgets - BOOTH\n\u003e\n\u003e https://74th.booth.pm/items/6934072\n\n\u003e CH32V003 Development Guidebook: 74th\n\u003e CH32V003開発ガイドブック：74th\n\u003e\n\u003e https://techbookfest.org/product/qH8sBZPnJAREuL45aDSfpa\n\nThis repository references the book content and extracted documents via Git submodules. They are not open source and are provided only to book purchasers.\nThe MCP Server containing the guidebook content is distributed as free software.\n\n🇯🇵\n本リポジトリにはGitサブモジュールで、技術同人誌の本文及び抽出ドキュメントを参照していますが、こちらは書籍購入者向けとしてオープンソースにはしておりません。\n技術同人誌の内容を含むMCP Serverを、フリーソフトウェアとして配布しています。\n\n## Overview\n\n🇯🇵\n概要\n\nThe tool `read_ch32v003_guide_book` is provided.\nBy specifying the framework and item arguments, the MCP Server returns relevant book content and sample code.\n\n🇯🇵\nツール`read_ch32v003_guide_book`を提供します。\n引数のframeworkとitemを指定することで、同人誌のコンテンツと、サンプルコードをMCP Serverが返します。\n\n- framework:\n  - WCH SDK\n  - ch32fun\n- item:\n  - GPIO\n  - Timer\n  - DMA\n  - ADC\n  - PWM\n  - I2C\n  - SPI\n  - UART\n  - watchdogtimer\n\nPlease specify the framework in advance when instructing the LLM.\nframeworkを指定する必要があるため、LLMにframeworkを指示しておいてください。\n\n## Usage\n\n🇯🇵\n利用方法\n\nDownload the binary from the [releases page](https://github.com/74th/ch32v003-guidebook-mcpserver/releases) and place it on your PC.\n\n🇯🇵\n[リリースページ](https://github.com/74th/ch32v003-guidebook-mcpserver/releases)からダウンロードして、PC内に設置してください。\n\n### Using GitHub Copilot in VS Code\n\n🇯🇵\nVS Codeで、GitHub Copilotを利用する場合\n\n#### Enable the MCP Server\n\n🇯🇵\nMCP Serverの有効化\n\nInstall the GitHub Copilot extension in VS Code.\nEdit or create `.vscode/mcp.json` in your repository and specify the path to the MCP Server as shown below.\n\n🇯🇵\nVS Codeで拡張機能GitHub Copilotをインストールしてください。\nリポジトリにて`.vscode/mcp.json`を編集、もしくは作成して、以下のように、設置したMCP Serverのパスを指定してください。\n\n```json\n{\n  \"servers\": {\n    \"guidebook\": {\n      \"command\": \"/Users/nnyn/ghq/github.com/74th/ch32v003-guidebook-mcpserver/ch32v003-guidebook-mcpserver\",\n      \"args\": [],\n      \"env\": {}\n    }\n  }\n}\n```\n\nOpen GitHub Copilot Chat, choose Agent Mode, and enable the tool as shown below.\n\n🇯🇵\n以下のように、GitHub Copilot Chatを開き、Agent Modeを選択した上で、Toolを有効化してください。\n\n![enable copilot](./docs/using_mcp_server_with_github_copilot.drawio.svg)\n\nIf the tool does not appear, try restarting the MCP Server.\n\n🇯🇵\nToolに表示されない場合、MCP Serverの再起動も試みてください。\n\nUse the tool `read_ch32v003_guide_book` in the chat prompt as follows. Make sure to tell the framework name (`WCH SDK` or `ch32fun`). The following is an example prompt.\n\n🇯🇵\nChatのプロンプトにて、以下のようにTool`read_ch32v003_guide_book`を使うように指示して利用してください。この時フレームワーク名を`WCH SDK`か`ch32fun`を教えておく必要があります。以下はプロンプトの例です。\n\n```\nI am developing firmware for the CH32V003 microcontroller.\nThe framework to use is ch32fun.\nFor implementation details with ch32fun, please refer to the Tool read_ch32v003_guide_book.\n\nPrepare to use UART. Also, provide code to read and write 1 byte at a baud rate of 115200.\n```\n\n🇯🇵\n\n```\nCH32V003マイコンのファームウェアの開発です\nフレームワークはch32funを使います\nch32funでの実装方法は、Tool read_ch32v003_guide_bookを参照してください。\n\nUARTを使う準備をして。ボーレート 115200で1バイト読み書きするコードも用意して。\n```\n\n#### Custom prompts so GitHub Copilot always uses the MCP Server\n\n🇯🇵\nMCP ServerをGitHub Copilotに使わせるようにカスタムプロンプトの指定\n\nYou can automatically add instructions without specifying the tool every time.\nEdit or create `.vscode/settings.json` in the repository and add `\"chat.promptFiles\": true`.\n\n🇯🇵\n毎回Toolを指定する指示をしなくても、自動でプロンプトに追加できます。\nリポジトリにて`.vscode/settings.json`を編集、もしくは作成して、`\"chat.promptFiles\": true`を追加してください。\n\n```json\n{\n  \"chat.promptFiles\": true\n}\n```\n\nWrite the following in `.github/copilot-instructions.md`.\n\n`.github/copilot-instructions.md`に以下のように記述してください。\n\n```markdown\nI am developing firmware for the CH32V003 microcontroller.\nThe framework to use is ch32fun.\nFor implementation details with ch32fun, please refer to the Tool read_ch32v003_guide_book.\n```\n\n🇯🇵\n\n```markdown\nCH32V003マイコンのファームウェアの開発です\nフレームワークはch32funを使います\nch32funでの実装方法は、Tool read_ch32v003_guide_bookを参照してください。\n```\n\n### Sample project files\n\n🇯🇵\nサンプルのプロジェクトファイル\n\nA sample project directory is provided.\n\n🇯🇵\nサンプルのプロジェクトフォルダを用意してあります。\n\n#### ch32fun\n\n[./sample_project_directory/ch32fun](./sample_project_directory/ch32fun/)\n\nThis is the ch32fun/examples/template with the above settings applied.\nRewrite the paths to ch32fun and ch32v003-guidebook-mcpserver in Makefile, .vscode/c_cpp_properties.json and .vscode/mcp.json before use.\n\nch32fun/examples/templateに上記設定を追加したものです。\nMakefile、.vscode/c_cpp_properties.json、.vscode/mcp.json中の、ch32fun及びch32v003-guidebook-mcpserverのパスを書き換えて利用してください。\n\n## Generation example\n\n🇯🇵\n生成サンプル\n\nHere is a sample prompt.\n\n🇯🇵\nプロンプトのサンプル例です。\n\n[./example_prompt.md](./example_prompt.md)\n\n## Notes\n\n🇯🇵\nご注意\n\nUsing this MCP Server does not guarantee a fully working CH32V003 firmware.\nIt is an experimental product and may not work as expected.\n\n🇯🇵\nこのMCP Serverを利用することで、完全に動作するCH32V003のファームウェアを作成を約束はしません。\n実験的なプロダクトです。期待通り動作しなくてもご容赦ください。\n\n## LICENSE\n\nThis program contains the following three types of works.\n\n🇯🇵\n本プログラムには以下の3種類の著作物が含まれます。\n\n1. Software portion - the code included in this repository\n  - 🇯🇵 ソフトウェア部分 … 本リポジトリに含まれるコード\n2. Doujinshi content portion - stored within the program or provided to book purchasers\n  - 🇯🇵 同人誌コンテンツ部分 …… プログラム内部に格納された、また同人誌購入者向けに提供される\n3. Sample code portion - stored within the program or public sample code\n  - 🇯🇵 サンプルコード部分 …… プログラム内部に格納された、または公開されているサンプルコード\n\nNo.1 is licensed under the MIT license. See [./LICENSE SECTION I](./LICENSE).\nNo.2 is licensed for personal use only. See [./LICENSE SECTION II](./LICENSE) for details.\nNo.3 is licensed under CC0.\n\n🇯🇵\n1.はMITライセンスが適用されます。原文は[./LICENSEのSECTION I](./LICENSE)を参照してください。\n2.は個人利用のみのライセンスです。詳しくは[./LICENSEのSECTION II](./LICENSE)を参照してください。\n3.はCC0ライセンスが適用されます。\n\nThe MCP Server program itself includes the license described in 2.\n\n🇯🇵\nMCP Serverのプログラム自体には、2.のライセンスが含まれます。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F74th%2Fch32v003-guidebook-mcpserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F74th%2Fch32v003-guidebook-mcpserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F74th%2Fch32v003-guidebook-mcpserver/lists"}