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:

git clone <repository-url>
cd project-portfolio-guide

2. Install dependencies:

npm install

3. Build the project:

npm run build

Usage

Local Development

Start the development server:

npm run dev

Production

Start the production server:

npm start

Docker

Build and run with Docker:

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:

{
  "content": "user message"
}

Response:

{
  "content": "server response",
  "metadata": {
    "step": 1,
    "totalSteps": 15
  }
}

GET /health

Check server health status.

Response:

{
  "status": "healthy"
}

Deployment to Smithery

1. Create a Smithery account at https://smithery.ai
2. Install the Smithery CLI:

npm install -g @smithery/cli

3. Login to Smithery:

smithery login

4. Deploy the server:

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