{"_id":"@andysama/marlin-mcp-server","_rev":"2-1b1a8b19005f2a6d46f424faba561d60","name":"@andysama/marlin-mcp-server","dist-tags":{"latest":"1.1.2"},"versions":{"1.1.1":{"name":"@andysama/marlin-mcp-server","version":"1.1.1","keywords":["mcp","marlin","hardware","verilog","verilator"],"author":{"name":"andysama"},"license":"MIT","_id":"@andysama/marlin-mcp-server@1.1.1","maintainers":[{"name":"andysamawork","email":"2540115445@qq.com"}],"homepage":"https://github.com/andysama/marlin-mcp-server#readme","bugs":{"url":"https://github.com/andysama/marlin-mcp-server/issues"},"bin":{"marlin-mcp-server":"dist/index.js"},"dist":{"shasum":"be438777afb4c257ee34b8b0162fe93de6facadb","tarball":"https://registry.npmjs.org/@andysama/marlin-mcp-server/-/marlin-mcp-server-1.1.1.tgz","fileCount":4,"integrity":"sha512-MJZ3y0tYAoYPR5ZPYoLkZKlxiW0vcl0JNgVu2vVPNPdXpCocN/k+O8b7hzKtc7elnAQoC02XmOri/gOjBouw1Q==","signatures":[{"sig":"MEYCIQDu8MIbpVLM4sOcpksNPmugSOaZZYkAQKpYTs9sQBBYkgIhAOvBQ3puAnEfvWgndq9EmlZ3wkOHoGY3sPdwwirR5U2k","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19098},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e8d9038076e8a3db6d14765ed80831554c075d7f","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"andysamawork","email":"2540115445@qq.com"},"repository":{"url":"git+https://github.com/andysama/marlin-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Marlin hardware testing library","directories":{},"_nodeVersion":"20.19.6","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"^5.3.0","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/marlin-mcp-server_1.1.1_1766501445622_0.21302538076478195","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@andysama/marlin-mcp-server","version":"1.1.2","description":"MCP server for Marlin hardware testing library","main":"dist/index.js","bin":{"marlin-mcp-server":"dist/index.js"},"type":"module","scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts"},"keywords":["mcp","marlin","hardware","verilog","verilator"],"author":{"name":"andysama"},"repository":{"type":"git","url":"git+https://github.com/andysama/marlin-mcp-server.git"},"homepage":"https://github.com/andysama/marlin-mcp-server#readme","bugs":{"url":"https://github.com/andysama/marlin-mcp-server/issues"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^20.10.0","tsx":"^4.7.0","typescript":"^5.3.0"},"_id":"@andysama/marlin-mcp-server@1.1.2","gitHead":"bca8ef7e4a0e671f374bfae5fcffb2fd8d2ceb4c","types":"./dist/index.d.ts","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-BvCFj9DVveh8Xtkq4L1fUfKxJ1/NvYvei3uf4CrX1kiIe8PQydVZYwhAKjNL4yFY/Xrytjn8sqTpY55NkEwZHA==","shasum":"cbb4c10bd68cb565b57bdcb1de83629110f69a5a","tarball":"https://registry.npmjs.org/@andysama/marlin-mcp-server/-/marlin-mcp-server-1.1.2.tgz","fileCount":4,"unpackedSize":20307,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDs9tntltu7JhZCjprfZamyjvlbQAjxA58+EHnYgQHCEQIgfX5K70J+PJoHB8G3kjoGx2Hwm+RhpS3JW4tiyq9LDOs="}]},"_npmUser":{"name":"andysamawork","email":"2540115445@qq.com"},"directories":{},"maintainers":[{"name":"andysamawork","email":"2540115445@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/marlin-mcp-server_1.1.2_1766501846989_0.7886129299781959"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-23T14:50:45.448Z","modified":"2025-12-23T14:57:27.343Z","1.1.1":"2025-12-23T14:50:45.836Z","1.1.2":"2025-12-23T14:57:27.131Z"},"bugs":{"url":"https://github.com/andysama/marlin-mcp-server/issues"},"author":{"name":"andysama"},"license":"MIT","homepage":"https://github.com/andysama/marlin-mcp-server#readme","keywords":["mcp","marlin","hardware","verilog","verilator"],"repository":{"type":"git","url":"git+https://github.com/andysama/marlin-mcp-server.git"},"description":"MCP server for Marlin hardware testing library","maintainers":[{"name":"andysamawork","email":"2540115445@qq.com"}],"readme":"# Marlin MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@andysama/marlin-mcp-server.svg)](https://www.npmjs.com/package/@andysama/marlin-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n一个用于 [Marlin](https://github.com/andysama/marlin) 硬件测试库的 MCP (Model Context Protocol) 服务器，让 AI 助手能够直接与 Marlin 项目交互。\n\n## 功能\n\n### 工具 (Tools)\n\n| 工具名 | 描述 |\n|--------|------|\n| `marlin_build` | 构建 Marlin 项目 |\n| `marlin_test` | 运行测试（支持指定包和测试名） |\n| `marlin_check` | 检查代码（不生成二进制） |\n| `marlin_list_modules` | 列出 Verilog/SystemVerilog 模块文件 |\n| `marlin_parse_verilog` | 解析 Verilog 文件，提取模块信息 |\n| `marlin_generate_test` | 生成 Rust 测试代码模板 |\n| `marlin_check_verilator` | 检查 Verilator 安装状态 |\n| `marlin_clean` | 清理构建产物 |\n\n### 资源 (Resources)\n\n- `marlin://workspace/cargo-toml` - Cargo.toml 配置文件\n- `marlin://workspace/readme` - README 文档\n\n## 安装\n\n### 方式一：npx 直接运行（推荐）\n\n```bash\nnpx @andysama/marlin-mcp-server\n```\n\n### 方式二：全局安装\n\n```bash\nnpm install -g @andysama/marlin-mcp-server\nmarlin-mcp-server\n```\n\n### 方式三：从源码构建\n\n```bash\ngit clone https://github.com/andysama/marlin-mcp-server.git\ncd marlin-mcp-server\nnpm install\nnpm run build\n```\n\n## 配置\n\n### Windsurf\n\n编辑 `~/.codeium/windsurf/mcp_config.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"marlin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@andysama/marlin-mcp-server\"],\n      \"env\": {\n        \"MARLIN_ROOT\": \"E:/vue/PiLoT/A-box/marlin\",\n        \"VERILATOR_ROOT\": \"E:/java-environment/msys64/mingw64/share/verilator\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\n编辑 `%APPDATA%/Claude/claude_desktop_config.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"marlin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@andysama/marlin-mcp-server\"],\n      \"env\": {\n        \"MARLIN_ROOT\": \"/path/to/marlin\",\n        \"VERILATOR_ROOT\": \"/usr/share/verilator\"\n      }\n    }\n  }\n}\n```\n\n### 环境变量\n\n| 变量名 | 说明 | 默认值 |\n|--------|------|--------|\n| `MARLIN_ROOT` | Marlin 项目根目录 | 当前工作目录 |\n| `VERILATOR_ROOT` | Verilator 安装目录 | 系统默认 |\n\n## 使用示例\n\n配置完成后，可以在 AI 助手中使用以下命令：\n\n### 构建项目\n\n```\n帮我构建 Marlin 项目\n```\n\n### 运行测试\n\n```\n运行 example-verilog-project 的测试\n```\n\n### 检查 Verilator\n\n```\n检查 Verilator 是否正确安装\n```\n\n### 解析 Verilog 模块\n\n```\n解析 examples/verilog-project/src/main.sv 文件\n```\n\n### 生成测试模板\n\n```\n为 Counter 模块生成测试代码，包含 clk、rst 输入和 count 输出\n```\n\n## 开发\n\n```bash\n# 安装依赖\nnpm install\n\n# 开发模式运行\nnpm run dev\n\n# 构建\nnpm run build\n\n# 运行\nnpm start\n```\n\n## 相关项目\n\n- [Marlin](https://github.com/andysama/marlin) - Rust 硬件测试框架\n- [Verilator](https://verilator.org/) - Verilog/SystemVerilog 仿真器\n\n## License\n\nMIT\n","readmeFilename":"README.md"}