https://github.com/AgileLuminary/mcp-agile-luminary
An MCP server for connecting with Agile Luminary Project Management Application
https://github.com/AgileLuminary/mcp-agile-luminary
agile-development claude-code cursor-ai mcp-server nodejs project-management windsurf-ai
Last synced: 3 months ago
JSON representation
An MCP server for connecting with Agile Luminary Project Management Application
- Host: GitHub
- URL: https://github.com/AgileLuminary/mcp-agile-luminary
- Owner: AgileLuminary
- License: mit
- Created: 2025-06-22T00:55:33.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-29T01:53:13.000Z (3 months ago)
- Last Synced: 2025-06-29T02:39:44.493Z (3 months ago)
- Topics: agile-development, claude-code, cursor-ai, mcp-server, nodejs, project-management, windsurf-ai
- Language: JavaScript
- Homepage: https://agileluminary.com
- Size: 2.25 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Agile Luminary - Simpler Project Management - send [Agile Luminary](https://agileluminary.com) stories straight to your IDE (Official Servers)
README
# Agile Luminary MCP Server
This is a Model Context Protocol (MCP) server that connects AI clients (like Cursor or Claude Desktop) to the Agile Luminary project management system hosted at `https://agileluminary.com`.
## What is MCP?
The Model Context Protocol (MCP) is a standardized way for AI applications to connect to external data sources and services. This server acts as a bridge between your AI client and the Agile Luminary REST API, allowing you to retrieve project details, work assignments, and documentation directly within your AI conversations.
## Architecture
```
AI Client (Cursor/Claude) → Local MCP Server → Agile Luminary API (localhost:5006)
```
## Features
This MCP server provides three main tools that fetch data from the Agile Luminary API:
### 📚 **getRelatedDocuments**
- **Purpose**: Retrieve related documents based on a search string
- **Parameters**: `searchString` (required) - The text to search for in documents
- **Use Case**: Find relevant documentation and specifications related to your current work
### 📋 **getCurrentWork**
- **Purpose**: Fetches work currently assigned to the user
- **Parameters**: None
- **Use Case**: See what tasks and user stories are actively assigned to you
### 🔍 **getPastWork**
- **Purpose**: Retrieves completed work related to user stories based on search criteria
- **Parameters**: `searchString` (required) - Search term to find relevant past work
- **Use Case**: Review historical context and completed tasks for better decision-making
## Installation & Setup
### Prerequisites
- Node.js (v16 or higher)
- An AI client that supports MCP (Cursor IDE, Claude Desktop, etc.)
### Install Dependencies
```bash
npm install @modelcontextprotocol/sdk zod
```
### Environment Variables
Set your API key as an environment variable:
```bash
export LUMINARY_API_KEY=your_api_key_here
```
### Run the Server
```bash
node server.js
```
The server will start and listen for connections from your AI client via stdio transport.
## Configuration
### For Cursor IDE
Add this to your MCP configuration:
```json
{
"mcpServers": {
"agile-luminary": {
"command": "node",
"args": ["path/to/your/server.js"],
"env": {
"LUMINARY_API_KEY": "your_api_key_here"
}
}
}
}
```
### For Claude Desktop
Add this to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"agile-luminary": {
"command": "node",
"args": ["path/to/your/server.js"],
"env": {
"LUMINARY_API_KEY": "your_api_key_here"
}
}
}
}
```
## Usage Examples
Once connected, you can use natural language in your AI client:
- *"Search for documents about authentication"*
- *"Show me my current work assignments"*
- *"Find past work related to user login functionality"*
- *"What documentation exists about the payment system?"*
- *"Based on my current work, what similar tasks were completed before?"*
## API Endpoints
The server connects to the following Agile Luminary API endpoints:
- `POST http://localhost:5006/bend/mcp/documents/search` - Search documents
- `GET http://localhost:5006/bend/mcp/userstories/current` - Get current work
- `POST http://localhost:5006/bend/mcp/userstories/search` - Search past work
## Benefits
- **Real-time Data**: Always get the latest project information from your deployed system
- **Context-Aware AI**: Your AI assistant has full context of your project status and documentation
- **Seamless Integration**: Works directly within your development environment
- **Secure**: Server handles authentication and API communication locally
- **Search Capabilities**: Find relevant documents and past work through intelligent search
## Authentication
The server uses the `LUMINARY_API_KEY` environment variable for authentication. This key is passed in the `Authorization` header for all API requests. Make sure to set this environment variable before running the server.
## Error Handling
The server includes comprehensive error handling for:
- Network connectivity issues
- API authentication failures
- Malformed responses
- Service unavailability
- Missing API keys
## Contributing
This MCP server is designed to work specifically with the Agile Luminary project management system. For modifications or enhancements, ensure compatibility with the existing API endpoints.
---
**Note**: Make sure your Agile Luminary account is created and you have your API key from `https://agileluminary.com` before using this MCP server. Set the `LUMINARY_API_KEY` environment variable with your API key.