devstride-mcp-server

DevStride MCP Server

A modern Model Context Protocol (MCP) server that provides seamless integration with the DevStride REST API using Node.js 20+/Bun, TypeScript, and the native fetch API.

🚀 Features

• Modern Runtime Support: Compatible with Node.js 20+ and Bun 1.0+
• Native Fetch API: Uses built-in fetch instead of external HTTP libraries
• Zero External HTTP Dependencies: Leverages modern JavaScript runtime capabilities
• Type-Safe Implementation: Full TypeScript support with strict typing
• FastMCP Framework: Built on the reliable FastMCP framework
• Comprehensive API Coverage: Access to all DevStride API endpoints
• Runtime Detection: Automatically detects and optimizes for Node.js or Bun

📋 Prerequisites

• Node.js 20.0.0+ or Bun 1.0.0+
• DevStride API credentials (API key, secret, and organization ID)

🛠 Installation

1. Clone the repository

   git clone https://github.com/jasonjgardner/devstride-mcp-server.git
   cd devstride-mcp-server
   

2. Install dependencies

   # Using npm
   npm install
   
   # Using Bun
   bun install
   

3. Configure environment variables

   cp .env.example .env
   # Edit .env with your DevStride API credentials
   

4. Build the project

   # Using npm
   npm run build
   
   # Using Bun
   bun run build
   

⚙️ Configuration

Create a .env file in the project root:

DEVSTRIDE_API_KEY=your_api_key_here
DEVSTRIDE_API_SECRET=your_api_secret_here
DEVSTRIDE_ORGANIZATION_ID=your_organization_id_here
DEVSTRIDE_API_BASE_URL=https://api.devstride.com
MCP_SERVER_NAME=DevStride MCP Server
MCP_SERVER_VERSION=2.0.0

Obtaining DevStride API Credentials

1. Log into your DevStride account
2. Go to Profile Settings
3. Navigate to API Keys and click "New Key"
4. Add a label and choose your organization
5. Copy the API key, secret, and organization ID

🏃‍♂️ Usage

Development Mode

With Node.js:

npm run dev

With Bun:

npm run dev:bun
# or
bun run src/index.ts

Production Mode

With Node.js:

npm start

With Bun:

npm run start:bun
# or
bun dist/index.js

Testing with MCP Inspector

npx @modelcontextprotocol/inspector src/index.ts

🔧 Available Tools

The server provides 10 comprehensive tools for DevStride API interaction:

Core Tools

• health_check - Test API connectivity and runtime information
• get_notifications - Retrieve organization notifications
• update_notification - Mark notifications as read or update content
• get_activity_logs - View activity logs for tracking changes

AI & Content Tools

• create_chat - Start new AI chat sessions
• generate_item_description - AI-powered content generation

Analytics & Export Tools

• create_export_job - Start data export processes
• get_export_jobs - List all export jobs and their status

Asset Management Tools

• create_asset_group - Organize assets into groups

Advanced Tools

• make_api_request - Custom API requests for any DevStride endpoint

📖 Usage Examples

Basic Health Check

{
  "tool": "health_check",
  "parameters": {}
}

Get Recent Notifications

{
  "tool": "get_notifications",
  "parameters": {
    "page": 1,
    "limit": 10
  }
}

Create AI Chat Session

{
  "tool": "create_chat",
  "parameters": {
    "title": "Project Planning Session",
    "initialMessage": "Help me plan the next sprint for our mobile app"
  }
}

Generate Content with AI

{
  "tool": "generate_item_description",
  "parameters": {
    "prompt": "Create a description for a new mobile app feature",
    "context": "E-commerce application with user authentication"
  }
}

Custom API Request

{
  "tool": "make_api_request",
  "parameters": {
    "method": "GET",
    "path": "/workflows",
    "params": {
      "active": true
    }
  }
}

🏗 Project Structure

devstride-mcp-server/
├── src/
│   ├── index.ts              # Main MCP server entry point
│   ├── types/
│   │   └── devstride.ts      # TypeScript type definitions
│   ├── services/
│   │   └── devstride-client.ts # Modern fetch-based API client
│   └── utils/
│       └── config.ts         # Configuration and runtime utilities
├── dist/                     # Compiled JavaScript output
├── package.json             # Project dependencies and scripts
├── tsconfig.json           # TypeScript configuration
├── .env.example            # Environment variables template
└── README.md               # This file

🔄 What's New in v2.0

Modern Runtime Support

• Node.js 20+: Leverages latest JavaScript features and performance improvements
• Bun Support: Full compatibility with Bun runtime for enhanced performance
• Runtime Detection: Automatically detects and reports the current runtime

Native Fetch API

• Zero HTTP Dependencies: Removed axios dependency in favor of native fetch
• Modern Error Handling: Improved error handling with fetch-specific error types
• Timeout Support: Built-in timeout handling using AbortController
• Better Performance: Reduced bundle size and improved startup time

Enhanced Features

• Improved Logging: Runtime-aware logging with better error reporting
• Type Safety: Enhanced TypeScript support with stricter typing
• Modern JavaScript: Uses ES2023 features for better performance and readability

🧪 Development

Available Scripts

• npm run build - Compile TypeScript to JavaScript
• npm run dev - Run in development mode with Node.js
• npm run dev:bun - Run in development mode with Bun
• npm start - Run compiled server with Node.js
• npm run start:bun - Run compiled server with Bun
• npm run lint - Run ESLint
• npm run format - Format code with Prettier

Code Quality

• TypeScript: Strict mode enabled with ES2023 target
• ESLint: Configured with TypeScript rules
• Prettier: Code formatting for consistency
• Modern Module Resolution: Uses bundler module resolution

🚀 Performance Benefits

Bun Runtime

• Faster Startup: Significantly faster cold start times
• Better Memory Usage: More efficient memory management
• Native TypeScript: Direct TypeScript execution without compilation

Native Fetch

• Reduced Bundle Size: No external HTTP library dependencies
• Better Performance: Native implementation optimized by runtime
• Modern Standards: Uses web standard APIs

🔍 Troubleshooting

Runtime Issues

• Ensure you're using Node.js 20+ or Bun 1.0+
• Check that fetch API is available in your runtime
• Verify environment variables are properly set

API Connectivity

• Use the health_check tool to verify API connectivity
• Check your DevStride API credentials
• Ensure network connectivity to api.devstride.com

Build Issues

• Clear the dist folder: npm run clean
• Reinstall dependencies: rm -rf node_modules && npm install
• Check TypeScript configuration

📄 License

MIT License - see LICENSE file for details

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📞 Support

For issues and questions:

• Check the for detailed technical information
• Use the health_check tool to diagnose connectivity issues
• Review server logs for detailed error information