Project Portfolio Guide MCP Server

# Project Portfolio Guide MCP Server A Model Context Protocol server that helps collect and structure project portfolio information through a guided conversation flow. ## Features - Step-by-step project information collection - GitHub repository integration - Structured data collection for project portfolios - RESTful API endpoints - Docker containerization support ## Prerequisites - Node.js 18.x or higher - npm or yarn - Docker (for containerized deployment) ## Installation 1. Clone the repository: ```bash git clone <repository-url> cd project-portfolio-guide ``` 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` ## Usage ### Local Development Start the development server: ```bash npm run dev ``` ### Production Start the production server: ```bash npm start ``` ### Docker Build and run with Docker: ```bash docker build -t project-portfolio-guide . docker run -p 3000:3000 project-portfolio-guide ``` ## API Endpoints ### POST /message Send a message to the server and receive the next step in the conversation. Request body: ```json { "content": "user message" } ``` Response: ```json { "content": "server response", "metadata": { "step": 1, "totalSteps": 15 } } ``` ### GET /health Check server health status. Response: ```json { "status": "healthy" } ``` ## Deployment to Smithery 1. Create a Smithery account at https://smithery.ai 2. Install the Smithery CLI: ```bash npm install -g @smithery/cli ``` 3. Login to Smithery: ```bash smithery login ``` 4. Deploy the server: ```bash smithery deploy ``` ## Configuration The server can be configured using environment variables: - `PORT`: Server port number (default: 3000) - `NODE_ENV`: Node environment (default: production) ## License MIT