{"id":"warashi-go-mcp-server-mds","name":"go-mcp-server-mds","homepage":null,"repo_url":"https://github.com/Warashi/go-mcp-server-mds","category":"devtools","subcategories":[],"tags":["go","mcp","modelcontextprotocol","markdown","filesystem","frontmatter","yaml","toml","docs"],"what_it_does":"Provides a Go-based MCP (Model Context Protocol) server that exposes markdown files from a local filesystem (via fs.FS) as MCP resources (file:// URIs) and tools to list and read markdown files. Supports YAML (---) and TOML (+++) frontmatter parsing and returns frontmatter metadata in tool outputs/resource descriptions.","use_cases":["Expose a directory of markdown docs to an MCP-capable agent as retrievable resources","Let agents list available markdown documents with basic metadata (size/frontmatter)","Retrieve full markdown content plus parsed frontmatter for downstream summarization/Q&A","Build local/offline knowledge bases backed by filesystem content","Create lightweight document-serving MCP servers for internal tooling"],"not_for":["Serving sensitive or access-controlled documents without additional isolation (no auth described)","Multi-tenant or internet-facing deployments without a reverse proxy/WAF and strict filesystem scoping","High-scale workloads requiring rate-limit guarantees or caching semantics (not documented)","Replacing a proper CMS/search index for large corpora"],"best_when":"Running locally or in a controlled internal environment where the agent only needs to read markdown from a known directory; filesystem contents are considered non-sensitive or already access-controlled by infrastructure.","avoid_when":"When you need strong authentication/authorization, audit logging, or safe handling of untrusted file paths/contents in a multi-user environment.","alternatives":["Using an MCP server or web API backed by a content system (e.g., Notion/Confluence/GitHub) with proper auth","Building a simple MCP server that reads from a database/index (Elasticsearch/Lucene) for larger corpora","Using a generic file-serving MCP template if available in your stack","Serving markdown via your own REST API with OpenAPI/SDKs instead of MCP"],"af_score":55.8,"security_score":25.8,"reliability_score":23.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T21:20:33.642272+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["None described (stdio-based MCP server)"],"oauth":false,"scopes":false,"notes":"No authentication or authorization mechanism is mentioned in the provided README; access is effectively determined by where/ how you run the server (stdio transport)."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing model applies for a self-hosted open-source Go library/binary."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":55.8,"security_score":25.8,"reliability_score":23.8,"mcp_server_quality":72.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":100.0,"rate_limit_clarity":0.0,"tls_enforcement":0.0,"auth_strength":20.0,"scope_granularity":10.0,"dependency_hygiene":45.0,"secret_handling":60.0,"security_notes":"Likely self-hosted over stdio (no TLS/auth in README). This reduces network attack surface but does not address authorization or filesystem safety. No information is provided about path traversal protection, input validation, logging of sensitive data, or dependency vulnerability status.","uptime_documented":0.0,"version_stability":35.0,"breaking_changes_history":30.0,"error_recovery":30.0,"idempotency_support":"true","idempotency_notes":"Read/list operations are inherently idempotent; no specific guidance documented on MCP error semantics.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["File path scoping/sanitization behavior is not described; agents should rely on the server to map URIs safely.","No auth described; ensure transport and execution context limit who can connect/call the server.","Frontmatter parsing delimiters are strict (YAML: --- , TOML: +++); malformed delimiters may lead to missing/invalid metadata depending on implementation."]}}