jhliberty/basecamp-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

5 stars 6 forks 品質 67 トレンド 13MIT

Repository Install

Basecamp 3 MCP (Model Context Protocol) server - 46 tools for complete Basecamp integration

概要

A modern for Basecamp 3, providing seamless integration with Claude Desktop and Cursor IDE through the Model Context Protocol. Built with the official @modelcontextprotocol/sdk and ready for NPX installation. ✅ Modern, type-safe implementation with full async/await support 🚀 Install and run with npx @basecamp/mcp-server ⚡ Complete Basecamp 3 integration with all major features - (required for ES modules) - A Basecamp 3 account - A Basecamp OAuth application (create one at https://launchpad.37signals.com/integrations) The setup script automatically: - ✅ Installs all TypeScript dependencies - ✅ Builds the project to dist/ - ✅ Creates .env template file - ✅ Tests MCP server functionality 4. Visit http://localhost:8000 and complete the OAuth flow. 7.

README

以下は原文 README の抜粋です。原文を見る。

Basecamp MCP Integration

A modern TypeScript MCP server for Basecamp 3, providing seamless integration with Claude Desktop and Cursor IDE through the Model Context Protocol. Built with the official @modelcontextprotocol/sdk and ready for NPX installation.

✅ TypeScript-First: Modern, type-safe implementation with full async/await support
🚀 NPX Ready: Install and run with npx @basecamp/mcp-server
⚡ 46 API Tools: Complete Basecamp 3 integration with all major features

Quick Setup

NPX Installation (Recommended)

# Install and set up in one command
npx jhliberty/basecamp-mcp-server setup

# Authenticate with Basecamp
npx jhliberty/basecamp-mcp-server auth

# Configure for your AI assistant
npx jhliberty/basecamp-mcp-server config claude   # For Claude Desktop
npx jhliberty/basecamp-mcp-server config cursor  # For Cursor IDE

Prerequisites

Node.js 18+ (required for ES modules)
A Basecamp 3 account
A Basecamp OAuth application (create one at https://launchpad.37signals.com/integrations)

Local Development Setup

For Development

Clone and build the project:

git clone 
cd basecamp-mcp-server
npm install
npm run build

Run setup script:
```
npm run setup
```
The setup script automatically:
- ✅ Installs all TypeScript dependencies
- ✅ Builds the project to dist/
- ✅ Creates .env template file
- ✅ Tests MCP server functionality

Configure OAuth credentials: Edit the generated .env file:

BASECAMP_CLIENT_ID=your_client_id_here
BASECAMP_CLIENT_SECRET=your_client_secret_here
BASECAMP_ACCOUNT_ID=your_account_id_here
USER_AGENT="Your App Name ([email protected])"

Authenticate with Basecamp:
```
npm run auth
```
Visit http://localhost:8000 and complete the OAuth flow.

Generate configurations:

npm run config:cursor  # For Cursor IDE
npm run config:claude  # For Claude Desktop

Restart your AI assistant completely (quit and reopen)
Verify in your AI assistant:
- Cursor: Go to Settings → MCP, look for “basecamp” with a green checkmark
- Claude Desktop: Look for tools icon (🔍) in chat interface
- Available tools: 46 tools for complete Basecamp control

Test Your Setup

# Quick test the MCP server
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | node dist/index.js

# Run automated tests  
npm test

# Run tests with UI
npm run test:ui

For Claude Desktop Users

Based on the official MCP quickstart guide, Claude Desktop integration follows these steps:

Setup Steps

GitHub で README 全文を見る

インストール

npx jhliberty/basecamp-mcp-server setup

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "basecamp": {
      "command": "node",
      "args": ["/path/to/your/project/dist/index.js"],
      "env": {
        "BASECAMP_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}