{"id":26896109,"url":"https://github.com/cheffromspace/coach-claude","last_synced_at":"2025-04-01T02:59:40.077Z","repository":{"id":269865018,"uuid":"908326682","full_name":"Cheffromspace/coach-claude","owner":"Cheffromspace","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-25T04:01:46.000Z","size":779,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T10:06:08.555Z","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":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cheffromspace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-12-25T18:40:47.000Z","updated_at":"2024-12-31T20:35:02.000Z","dependencies_parsed_at":"2024-12-26T18:48:55.445Z","dependency_job_id":"58fe3871-0637-4f11-8c79-a770100477e2","html_url":"https://github.com/Cheffromspace/coach-claude","commit_stats":null,"previous_names":["cheffromspace/coach-claude"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cheffromspace%2Fcoach-claude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cheffromspace%2Fcoach-claude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cheffromspace%2Fcoach-claude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cheffromspace%2Fcoach-claude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cheffromspace","download_url":"https://codeload.github.com/Cheffromspace/coach-claude/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246574840,"owners_count":20799221,"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","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-04-01T02:59:39.502Z","updated_at":"2025-04-01T02:59:40.069Z","avatar_url":"https://github.com/Cheffromspace.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Coach Claude - Extensible AI Development Platform\n\nCoach Claude is a collection of interoperable projects built on the Model Context Protocol (MCP), focusing on extensible AI integration with knowledge management systems. The platform currently consists of two main projects that will be separated into independent repositories:\n\n1. A Windows-optimized MCP client for AI model integration\n2. An extensible Obsidian MCP server with a powerful plugin system\n\n![MCP Architecture](docs/images/mcp-architecture.png)\n\n## 🏗️ Project Architecture\n\n### MCP Client (Windows-focused)\nA standalone Python-based client that implements the Model Context Protocol:\n\n- **Extensible Message Processing**\n  - Pluggable message processors\n  - Custom tool handlers\n  - Flexible caching strategies\n  - Query processing pipeline\n\n- **Server Management**\n  - Dynamic server discovery\n  - Connection lifecycle management\n  - Health monitoring\n  - Process isolation\n\n- **Configuration System**\n  - Server configuration\n  - Tool definitions\n  - Environment management\n  - Logging infrastructure\n\n### Obsidian MCP Server\nA TypeScript-based server providing extensible Obsidian integration:\n\n- **Plugin System Architecture**\n```typescript\ninterface MCPPlugin {\n  name: string;\n  version: string;\n  description?: string;\n  \n  onLoad(): Promise\u003cvoid\u003e;\n  onUnload(): Promise\u003cvoid\u003e;\n  \n  getTools(): ToolDefinition[];\n  getResources?(): ResourceDefinition[];\n}\n```\n\n- **Core Plugin Features**\n  - Note operations (CRUD)\n  - Advanced search capabilities\n  - Tag management system\n  - Metadata handling\n\n- **Specialized Plugins**\n  - Coaching functionality\n  - Health tracking\n  - Tool documentation\n  - Custom plugin support\n\n## 🛠️ Technology Stack\n\n### MCP Client\n- Python 3.8+\n- UV for dependency management\n- Windows-optimized socket operations\n- Protocol buffers\n- asyncio for async operations\n\n### Obsidian Server\n- TypeScript\n- Node.js\n- MCP SDK\n- Plugin architecture\n\n## 🔌 Extensibility\n\n### MCP Client Extensions\n- Custom message processors\n- Tool handler plugins\n- Cache strategy implementations\n- Server type definitions\n\n### Obsidian Server Plugins\nPlugins can be developed independently and will be distributed as separate packages:\n\n- **Core Plugin** (Will be separate package)\n  - Essential Obsidian operations\n  - Base functionality for other plugins\n\n- **Coaching Plugin** (Will be separate package)\n  - Personal development features\n  - Goal tracking system\n\n- **Health Plugin** (Will be separate package)\n  - Wellness tracking\n  - Metric management\n\n## 🚀 Getting Started\n\n### System Requirements\n- Windows 10 or later\n- Python 3.8+\n- Node.js 18+\n- Obsidian desktop app\n\n### Installation\n\n1. **Clone Current Repository**\n   ```cmd\n   git clone https://github.com/yourusername/coach-claude.git\n   cd coach-claude\n   ```\n\n2. **MCP Client Setup**\n   ```cmd\n   cd mcp_client\n   python -m venv .venv\n   .venv\\Scripts\\activate\n   uv pip install -r requirements.txt\n   ```\n\n3. **Obsidian Server Setup**\n   ```cmd\n   cd mcp-servers/obsidian-server\n   npm install\n   ```\n\n### Configuration\n1. Configure MCP servers in `%APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json`\n2. Set up Obsidian vault path\n3. Configure plugin settings as needed\n\n## 🔒 Security\n\n- Local-first architecture\n- Process isolation\n- Controlled resource access\n- Standardized security protocols\n\n## 📝 Documentation\n\n- [System Architecture](docs/system-architecture.md)\n- [Plugin Development Guide](docs/plugin-development-guide.md)\n- [API Reference](docs/api-reference.md)\n\n## 🎯 Future Development\n\n### Project Separation\nThe following components will become independent projects:\n\n1. MCP Client\n   - Core protocol implementation\n   - Extension system\n   - Server management\n\n2. Obsidian MCP Server\n   - Base server functionality\n   - Plugin management system\n   - Core Obsidian operations\n\n3. Individual Plugin Packages\n   - Core Plugin\n   - Coaching Plugin\n   - Health Plugin\n   - Community plugins\n\n4. Web Interface (Planned)\n   - Next.js-based dashboard\n   - Real-time updates\n   - Plugin management\n\n## 📄 Licensing\n\nThis project consists of multiple components with different licenses:\n\n1. **Obsidian MCP Server (Base)**\n   - MIT License\n   - Free to use, modify, and distribute\n   - See [mcp-servers/obsidian-server/LICENSE](mcp-servers/obsidian-server/LICENSE)\n\n2. **MCP Client \u0026 Coaching Plugin**\n   - Proprietary License\n   - All rights reserved\n   - Commercial use restricted to the copyright holder\n\n## 📧 Contact\n\nFor questions and support, please open an issue or contact the maintainers.\n\n---\n\nBuilt with ❤️ by the Coach Claude team\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcheffromspace%2Fcoach-claude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcheffromspace%2Fcoach-claude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcheffromspace%2Fcoach-claude/lists"}