{"id":35026376,"url":"https://github.com/reflex-dev/mcp-example","last_synced_at":"2025-12-27T06:26:37.937Z","repository":{"id":324144296,"uuid":"1096125466","full_name":"reflex-dev/mcp-example","owner":"reflex-dev","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-14T02:23:21.000Z","size":60,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-14T04:23:40.157Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/reflex-dev.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-11-14T01:15:52.000Z","updated_at":"2025-11-14T02:23:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/reflex-dev/mcp-example","commit_stats":null,"previous_names":["reflex-dev/mcp-example"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/reflex-dev/mcp-example","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reflex-dev%2Fmcp-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reflex-dev%2Fmcp-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reflex-dev%2Fmcp-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reflex-dev%2Fmcp-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reflex-dev","download_url":"https://codeload.github.com/reflex-dev/mcp-example/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reflex-dev%2Fmcp-example/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28074186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-27T02:00:05.897Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2025-12-27T06:26:33.020Z","updated_at":"2025-12-27T06:26:37.928Z","avatar_url":"https://github.com/reflex-dev.png","language":"Python","readme":"# MCP Docs Server\n\nA simple way to make your documentation files available to AI assistants like Claude.\n\n## What Does This Do?\n\nThink of this as a **library catalog for your documentation**. You have a bunch of markdown files (`.md` files) with documentation, guides, or notes. This server:\n\n1. Finds all your markdown files automatically\n2. Makes them available to AI tools through something called MCP (Model Context Protocol)\n3. Lets AI assistants search through and read your documentation\n\nIt's like giving Claude or other AI tools a filing cabinet of your documentation that they can open and read whenever they need information.\n\n## How It Works (Simple Explanation)\n\n1. **You put documentation files in folders** - Just save your `.md` files in organized folders\n2. **The server finds them automatically** - No need to manually register each file\n3. **AI can read them** - AI assistants can now access and search your documentation\n\n### Real Example\n\nLet's say you have documentation for \"Service 1\" with these files:\n- `user-functions.md` - How user features work\n- `call-functions.md` - How calling features work\n- `calendar-functions.md` - How calendar features work\n\nYou would organize them like this:\n\n```\ndocs/\n└── service-1/\n    ├── user-functions.md\n    ├── call-functions.md\n    └── calendar-functions.md\n```\n\nThat's it! The server will automatically find these files and make them available as:\n- `docs://service-1/user-functions`\n- `docs://service-1/call-functions`\n- `docs://service-1/calendar-functions`\n\n## Quick Start (Step by Step)\n\n### Step 1: Install Python Requirements\n\nYou need Python 3.10 or newer and `uv` (a Python package manager) installed.\n\nInstall `uv` if you don't have it:\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nThen install the required package:\n\n```bash\nuv pip install mcp\n```\n\n### Step 2: Add Your Documentation Files\n\nPut your markdown files in the `docs/` folder. Organize them in subfolders by topic or service:\n\n```\ndocs/\n├── service-1/\n│   ├── user-functions.md\n│   ├── call-functions.md\n│   └── calendar-functions.md\n├── service-2/\n│   └── api-guide.md\n└── getting-started/\n    └── introduction.md\n```\n\nThe subfolder name (like `service-1`) becomes the category.\n\n### Step 3: Connect to Claude Code\n\nThe easiest way is to use the Claude Code CLI. From this project folder, run:\n\n```bash\nclaude mcp add --transport stdio docs -- uv run python /full/path/to/mcp-example/src/mcp_docs_server.py\n```\n\nReplace `/full/path/to/mcp-example` with your actual project path.\n\nVerify it's connected:\n\n```bash\nclaude mcp list\n```\n\nYou should see: `docs: ... - ✓ Connected`\n\nThat's it! Claude Code can now access your documentation.\n\n## Adding New Documentation\n\nTo add new documentation at any time:\n\n1. Create a new `.md` file in the appropriate folder under `docs/`\n2. That's it! The server finds new files automatically\n\nFor example, to add documentation for a new service:\n\n```\ndocs/\n└── service-3/          # Create new folder\n    └── setup.md        # Add your documentation file\n```\n\nNo need to restart the server or change any code.\n\n## Using with Claude Code\n\nIf you're using Claude Code (the CLI tool), follow Step 3 above. The server is already configured and running!\n\nYou can now ask Claude Code questions like:\n- \"List all available docs resources\"\n- \"Read the service-1/user-functions documentation\"\n- \"Search the docs for authentication\"\n\nClaude Code will automatically access your documentation files.\n\n### Managing the Server\n\nCheck if the server is connected:\n```bash\nclaude mcp list\n```\n\nRemove the server:\n```bash\nclaude mcp remove docs\n```\n\nRe-add the server if needed:\n```bash\nclaude mcp add --transport stdio docs -- uv run python /full/path/to/mcp-example/src/mcp_docs_server.py\n```\n\n## Connecting to Claude Desktop\n\nTo make your documentation available in Claude Desktop:\n\n1. Find your Claude Desktop config file:\n   - **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n2. Open the file and add this (replace `/path/to/mcp-example` with your actual folder path):\n\n```json\n{\n  \"mcpServers\": {\n    \"docs\": {\n      \"command\": \"python\",\n      \"args\": [\"/path/to/mcp-example/src/mcp_docs_server.py\"]\n    }\n  }\n}\n```\n\n## Learn More\n\n- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) - Build your own MCP servers\n- [MCP Documentation](https://modelcontextprotocol.io) - Learn about Model Context Protocol\n- [MCP Python SDK Docs](https://modelcontextprotocol.github.io/python-sdk/) - Complete SDK reference\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freflex-dev%2Fmcp-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freflex-dev%2Fmcp-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freflex-dev%2Fmcp-example/lists"}