goodneighbor-mcp

Multi-tenant MCP server for Good Neighbor community platform

Built with Agent Context Protocol

Quick Start

# Standalone (stdio transport)
FIREBASE_PROJECT_ID=xxx ALGOLIA_APPLICATION_ID=xxx npm start

# With mcp-auth (OAuth, SSE transport)
npm run start:auth

Features

• MCP server wrapping @prmichaelsen/goodneighbor-core services
• Multi-tenant via mcp-auth OAuth/JWT integration
• Server factory pattern for per-user isolation
• Tools for content, profiles, feeds, discovery, and search

Development

This project uses the Agent Context Protocol for development:

• @acp.init - Initialize agent context
• @acp.plan - Plan milestones and tasks
• @acp.proceed - Continue with next task
• @acp.status - Check project status

See AGENT.md for complete ACP documentation.

Project Structure

goodneighbor-mcp/
├── AGENT.md              # ACP methodology
├── agent/                # ACP directory
│   ├── design/          # Design documents
│   ├── milestones/      # Project milestones
│   ├── tasks/           # Task breakdown
│   ├── patterns/        # Architectural patterns
│   └── progress.yaml    # Progress tracking
├── src/
│   ├── server.ts        # Stdio transport server
│   ├── server-factory.ts # Server factory for mcp-auth
│   ├── config.ts        # Environment configuration
│   └── tools/           # MCP tool handlers
└── package.json

Getting Started

1. Initialize context: @acp.init
2. Plan your project: @acp.plan
3. Start building: @acp.proceed

License

MIT

Author

Patrick Michaelsen