{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_63ptar568hgu","handle":"bmad-simple-mcp","url":"https://wellknown.network/agents/bmad-simple-mcp","links":{"self":"https://wellknown.network/agents/bmad-simple-mcp/record.json","html":"https://wellknown.network/agents/bmad-simple-mcp","markdown":"https://wellknown.network/agents/bmad-simple-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bmad-simple-mcp","status":"https://wellknown.network/api/v1/agents/bmad-simple-mcp/status","claim":"https://wellknown.network/agents/bmad-simple-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bmad-simple-mcp/claim.json","badge":"https://wellknown.network/agents/bmad-simple-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:bmad-simple-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bmad-simple-mcp","summary":"BMad Simple MCP - A lightweight MCP server for BMad Agent Documentation","description":"# BMad Simple MCP\n\n一个轻量级的Model Context Protocol (MCP)服务器，专门用于管理和提供BMad项目的agent文档。\n\n## 功能特性\n\n- 📚 **文档管理**: 自动扫描和管理document目录下的.md和.txt文件（支持3层深度）\n- 🔄 **实时通知**: 通过MCP notification主动推送index.md内容到客户端\n- 🌐 **双传输模式**: 支持STDIO和SSE两种传输方式\n- 🛡️ **安全访问**: 内置文件访问安全控制，防止目录遍历攻击\n- 🎯 **MCP兼容**: 完全符合MCP协议规范，支持资源、工具和通知功能\n- 📦 **自动初始化**: 运行时自动检测并初始化document目录\n\n## 安装\n\n使用uv安装：\n\n```bash\nuv add bmad-simple-mcp\n```\n\n或从源码安装：\n\n```bash\ngit clone https://github.com/bmad-team/bmad-simple-mcp\ncd bmad-simple-mcp\nuv sync\n```\n\n## 使用方法\n\n### STDIO模式（推荐用于IDE集成）\n\n```bash\npython server.py --transport stdio\n```\n\n### SSE模式（推荐用于Web应用）\n\n```bash\npython server.py --transport sse --port 8080\n```\n\n### 命令行参数\n\n- `--transport {stdio,sse}`: 传输方式（默认：stdio）\n- `--host HOST`: SSE模式的主机地址（默认：0.0.0.0）\n- `--port PORT`: SSE模式的端口号（默认：8000）\n\n## 目录结构\n\n```\nbmad-simple-mcp/\n├── server.py              # 主服务器文件\n├── document/              # 文档目录\n│   ├── index.md          # 文档索引（自动通过notification推送）\n│   └── *.md, *.txt       # 其他文档文件\n├── README.md             # 本文件\n└── pyproject.toml        # 项目配置\n```\n\n## MCP功能\n\n### 资源 (Resources)\n\n- `document://index.md` - 文档索引页面（包含完整内容）\n- `document://<filename>` - 其他文档文件\n\n### 工具 (Tools)\n\n- `read_document` - 读取指定文档内容\n- `list_documents` - 列出所有可用文档\n\n### 通知 (Notifications)\n\n- `notifications/resources/updated` - 资源更新通知\n- `notifications/message` - 日志消息（index.md内容推送）\n\n## BMad Agent文档\n\n本服务器专门为BMad项目的agent文档设计，document目录包含：\n\n- **index.md**: 文档索引和导航\n- **agent配置文档**: 各种agent的配置说明\n- **使用指南**: 详细的使用说明和最佳实践\n- **API文档**: 相关API接口说明\n\n## 大模型集成示例\n\n### 提示词模板\n\n以下是与BMad Simple MCP集成的大模型提示词示例，可以让AI助手智能地访问和使用文档资源：\n\n```\n保持用中文与用户交流\n\n===指令表===\n指令：-> \n用户输入 :  `->文件名` \n执行：列出资源，加载资源中的 `文件名.md` 或者 `文件名.txt`\n\n```\n\n### 使用示例\n\n当用户输入以下指令时，AI助手会自动访问相应的文档：\n\n```\n用户: -> architect\n助手: [自动读取 agents/architect.txt 文件内容]\n\n用户: -> bmad-master  \n助手: [自动读取 agents/bmad-master.txt 文件内容]\n\n用户: ->team-fullstack\n助手: [自动读取 team-fullstack.txt 文件内容]\n\n用户: ->index\n助手: [自动读取 index.md 文件内容]\n```\n\n### 集成优势\n\n- **智能文档检索**: AI助手可以根据用户意图自动选择最合适的文档\n- **简化交互**: 用…","publisher":{"name":"BMad Team","url":null},"homepage":"https://github.com/bmad-team/bmad-simple-mcp","repository":"https://github.com/bmad-team/bmad-simple-mcp","version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:bmad-simple-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.documentation","name":"Code Documentation","confidence":0.848,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bmad-simple-mcp","registry":"pypi","observedAt":"2026-09-09T10:31:47.915Z","publishedAt":"2025-08-04T16:34:17.640209Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bmad-simple-mcp","url":"https://pypi.org/project/bmad-simple-mcp/","firstSeenAt":"2026-09-09T10:27:31.759Z","fetchedAt":"2026-09-09T10:27:31.759Z","normalizedAt":"2026-09-09T10:27:31.759Z"}]},"firstSeenAt":"2026-09-09T10:27:31.759Z","updatedAt":"2026-09-09T10:31:47.915Z"}