2025-06-02 17:11:39 +01:00
#!/usr/bin/env python3
"""
Command - line MCP server for Basecamp integration with Cursor .
This server implements the MCP ( Model Context Protocol ) via stdin / stdout
as expected by Cursor .
"""
import json
import sys
import logging
from typing import Any , Dict , List , Optional
from basecamp_client import BasecampClient
from search_utils import BasecampSearch
import token_storage
import os
from dotenv import load_dotenv
# Determine project root (directory containing this script)
PROJECT_ROOT = os . path . dirname ( os . path . abspath ( __file__ ) )
# Explicitly load .env from the project root
DOTENV_PATH = os . path . join ( PROJECT_ROOT , ' .env ' )
load_dotenv ( DOTENV_PATH )
# Log file in the project directory
LOG_FILE_PATH = os . path . join ( PROJECT_ROOT , ' mcp_cli_server.log ' )
# Set up logging to file AND stderr
logging . basicConfig (
level = logging . DEBUG ,
format = ' %(asctime)s - %(name)s - %(levelname)s - %(message)s ' ,
handlers = [
logging . FileHandler ( LOG_FILE_PATH ) ,
logging . StreamHandler ( sys . stderr ) # Added StreamHandler for stderr
]
)
logger = logging . getLogger ( ' mcp_cli_server ' )
class MCPServer :
""" MCP server implementing the Model Context Protocol for Cursor. """
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
def __init__ ( self ) :
self . tools = self . _get_available_tools ( )
logger . info ( " MCP CLI Server initialized " )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
def _get_available_tools ( self ) - > List [ Dict [ str , Any ] ] :
""" Get list of available tools for Basecamp. """
return [
{
" name " : " get_projects " ,
" description " : " Get all Basecamp projects " ,
" inputSchema " : {
" type " : " object " ,
" properties " : { } ,
" required " : [ ]
}
} ,
{
" name " : " get_project " ,
" description " : " Get details for a specific project " ,
" inputSchema " : {
2025-06-06 10:23:50 +01:00
" type " : " object " ,
2025-06-02 17:11:39 +01:00
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " }
} ,
" required " : [ " project_id " ]
}
} ,
{
" name " : " get_todolists " ,
" description " : " Get todo lists for a project " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " }
} ,
" required " : [ " project_id " ]
}
} ,
{
" name " : " get_todos " ,
" description " : " Get todos from a todo list " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
2025-06-05 18:51:36 +07:00
" project_id " : { " type " : " string " , " description " : " Project ID " } ,
" todolist_id " : { " type " : " string " , " description " : " The todo list ID " } ,
2025-06-02 17:11:39 +01:00
} ,
2025-06-05 18:51:36 +07:00
" required " : [ " project_id " , " todolist_id " ]
2025-06-02 17:11:39 +01:00
}
} ,
{
" name " : " search_basecamp " ,
" description " : " Search across Basecamp projects, todos, and messages " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" query " : { " type " : " string " , " description " : " Search query " } ,
" project_id " : { " type " : " string " , " description " : " Optional project ID to limit search scope " }
} ,
" required " : [ " query " ]
}
} ,
2025-06-18 08:17:55 +01:00
{
" name " : " global_search " ,
" description " : " Search projects, todos and campfire messages across all projects " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" query " : { " type " : " string " , " description " : " Search query " }
} ,
" required " : [ " query " ]
}
} ,
2025-06-02 17:11:39 +01:00
{
" name " : " get_comments " ,
" description " : " Get comments for a Basecamp item " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" recording_id " : { " type " : " string " , " description " : " The item ID " } ,
2025-06-05 18:51:36 +07:00
" project_id " : { " type " : " string " , " description " : " The project ID " }
2025-06-02 17:11:39 +01:00
} ,
2025-06-05 18:51:36 +07:00
" required " : [ " recording_id " , " project_id " ]
2025-06-02 17:11:39 +01:00
}
} ,
{
" name " : " get_campfire_lines " ,
" description " : " Get recent messages from a Basecamp campfire (chat room) " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" campfire_id " : { " type " : " string " , " description " : " The campfire/chat room ID " }
} ,
" required " : [ " project_id " , " campfire_id " ]
}
2025-06-05 18:51:36 +07:00
} ,
{
" name " : " get_daily_check_ins " ,
" description " : " Get project ' s daily checking questionnaire " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" page " : { " type " : " integer " , " description " : " Page number paginated response " }
}
} ,
" required " : [ " project_id " ]
} ,
{
" name " : " get_question_answers " ,
" description " : " Get answers on daily check-in question " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" question_id " : { " type " : " string " , " description " : " The question ID " } ,
" page " : { " type " : " integer " , " description " : " Page number paginated response " }
}
} ,
" required " : [ " project_id " , " question_id " ]
2025-06-26 22:34:01 +01:00
} ,
# Card Table tools
2025-06-29 08:22:09 +01:00
{
" name " : " get_card_tables " ,
" description " : " Get all card tables for a project " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " }
} ,
" required " : [ " project_id " ]
}
} ,
2025-06-26 22:34:01 +01:00
{
" name " : " get_card_table " ,
" description " : " Get the card table details for a project " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " }
} ,
" required " : [ " project_id " ]
}
} ,
{
" name " : " get_columns " ,
" description " : " Get all columns in a card table " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_table_id " : { " type " : " string " , " description " : " The card table ID " }
} ,
" required " : [ " project_id " , " card_table_id " ]
}
} ,
{
" name " : " get_column " ,
" description " : " Get details for a specific column " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " }
} ,
" required " : [ " project_id " , " column_id " ]
}
} ,
{
" name " : " create_column " ,
" description " : " Create a new column in a card table " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_table_id " : { " type " : " string " , " description " : " The card table ID " } ,
" title " : { " type " : " string " , " description " : " The column title " }
} ,
" required " : [ " project_id " , " card_table_id " , " title " ]
}
} ,
{
" name " : " update_column " ,
" description " : " Update a column title " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " } ,
" title " : { " type " : " string " , " description " : " The new column title " }
} ,
" required " : [ " project_id " , " column_id " , " title " ]
}
} ,
{
" name " : " move_column " ,
" description " : " Move a column to a new position " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
2025-06-29 08:37:41 +01:00
" card_table_id " : { " type " : " string " , " description " : " The card table ID " } ,
2025-06-26 22:34:01 +01:00
" column_id " : { " type " : " string " , " description " : " The column ID " } ,
" position " : { " type " : " integer " , " description " : " The new 1-based position " }
} ,
2025-06-29 08:37:41 +01:00
" required " : [ " project_id " , " card_table_id " , " column_id " , " position " ]
2025-06-26 22:34:01 +01:00
}
} ,
{
" name " : " update_column_color " ,
" description " : " Update a column color " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " } ,
" color " : { " type " : " string " , " description " : " The hex color code (e.g., #FF0000) " }
} ,
" required " : [ " project_id " , " column_id " , " color " ]
}
} ,
{
" name " : " put_column_on_hold " ,
" description " : " Put a column on hold (freeze work) " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " }
} ,
" required " : [ " project_id " , " column_id " ]
}
} ,
{
" name " : " remove_column_hold " ,
" description " : " Remove hold from a column (unfreeze work) " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " }
} ,
" required " : [ " project_id " , " column_id " ]
}
} ,
{
" name " : " watch_column " ,
" description " : " Subscribe to notifications for changes in a column " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " }
} ,
" required " : [ " project_id " , " column_id " ]
}
} ,
{
" name " : " unwatch_column " ,
" description " : " Unsubscribe from notifications for a column " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " }
} ,
" required " : [ " project_id " , " column_id " ]
}
} ,
{
" name " : " get_cards " ,
" description " : " Get all cards in a column " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " }
} ,
" required " : [ " project_id " , " column_id " ]
}
} ,
{
" name " : " get_card " ,
" description " : " Get details for a specific card " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_id " : { " type " : " string " , " description " : " The card ID " }
} ,
" required " : [ " project_id " , " card_id " ]
}
} ,
{
" name " : " create_card " ,
" description " : " Create a new card in a column " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" column_id " : { " type " : " string " , " description " : " The column ID " } ,
" title " : { " type " : " string " , " description " : " The card title " } ,
2025-06-29 08:22:09 +01:00
" content " : { " type " : " string " , " description " : " Optional card content/description " } ,
" due_on " : { " type " : " string " , " description " : " Optional due date (ISO 8601 format) " } ,
" notify " : { " type " : " boolean " , " description " : " Whether to notify assignees (default: false) " }
2025-06-26 22:34:01 +01:00
} ,
" required " : [ " project_id " , " column_id " , " title " ]
}
} ,
{
" name " : " update_card " ,
" description " : " Update a card " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_id " : { " type " : " string " , " description " : " The card ID " } ,
" title " : { " type " : " string " , " description " : " The new card title " } ,
2025-06-29 08:22:09 +01:00
" content " : { " type " : " string " , " description " : " The new card content/description " } ,
" due_on " : { " type " : " string " , " description " : " Due date (ISO 8601 format) " } ,
" assignee_ids " : { " type " : " array " , " items " : { " type " : " string " } , " description " : " Array of person IDs to assign to the card " }
2025-06-26 22:34:01 +01:00
} ,
" required " : [ " project_id " , " card_id " ]
}
} ,
{
" name " : " move_card " ,
2025-06-29 08:22:09 +01:00
" description " : " Move a card to a new column " ,
2025-06-26 22:34:01 +01:00
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_id " : { " type " : " string " , " description " : " The card ID " } ,
2025-06-29 08:22:09 +01:00
" column_id " : { " type " : " string " , " description " : " The destination column ID " }
} ,
" required " : [ " project_id " , " card_id " , " column_id " ]
}
} ,
{
" name " : " complete_card " ,
" description " : " Mark a card as complete " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_id " : { " type " : " string " , " description " : " The card ID " }
} ,
" required " : [ " project_id " , " card_id " ]
}
} ,
{
" name " : " uncomplete_card " ,
" description " : " Mark a card as incomplete " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_id " : { " type " : " string " , " description " : " The card ID " }
} ,
" required " : [ " project_id " , " card_id " ]
}
} ,
{
" name " : " get_card_steps " ,
" description " : " Get all steps (sub-tasks) for a card " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_id " : { " type " : " string " , " description " : " The card ID " }
2025-06-26 22:34:01 +01:00
} ,
" required " : [ " project_id " , " card_id " ]
}
2025-06-29 08:22:09 +01:00
} ,
{
" name " : " create_card_step " ,
" description " : " Create a new step (sub-task) for a card " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" card_id " : { " type " : " string " , " description " : " The card ID " } ,
" title " : { " type " : " string " , " description " : " The step title " } ,
" due_on " : { " type " : " string " , " description " : " Optional due date (ISO 8601 format) " } ,
" assignee_ids " : { " type " : " array " , " items " : { " type " : " string " } , " description " : " Array of person IDs to assign to the step " }
} ,
" required " : [ " project_id " , " card_id " , " title " ]
}
} ,
{
" name " : " get_card_step " ,
" description " : " Get details for a specific card step " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" step_id " : { " type " : " string " , " description " : " The step ID " }
} ,
" required " : [ " project_id " , " step_id " ]
}
} ,
{
" name " : " update_card_step " ,
" description " : " Update a card step " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" step_id " : { " type " : " string " , " description " : " The step ID " } ,
" title " : { " type " : " string " , " description " : " The step title " } ,
" due_on " : { " type " : " string " , " description " : " Due date (ISO 8601 format) " } ,
" assignee_ids " : { " type " : " array " , " items " : { " type " : " string " } , " description " : " Array of person IDs to assign to the step " }
} ,
" required " : [ " project_id " , " step_id " ]
}
} ,
{
" name " : " delete_card_step " ,
" description " : " Delete a card step " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" step_id " : { " type " : " string " , " description " : " The step ID " }
} ,
" required " : [ " project_id " , " step_id " ]
}
} ,
{
" name " : " complete_card_step " ,
" description " : " Mark a card step as complete " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" step_id " : { " type " : " string " , " description " : " The step ID " }
} ,
" required " : [ " project_id " , " step_id " ]
}
} ,
{
" name " : " uncomplete_card_step " ,
" description " : " Mark a card step as incomplete " ,
" inputSchema " : {
" type " : " object " ,
" properties " : {
" project_id " : { " type " : " string " , " description " : " The project ID " } ,
" step_id " : { " type " : " string " , " description " : " The step ID " }
} ,
" required " : [ " project_id " , " step_id " ]
}
2025-06-02 17:11:39 +01:00
}
]
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
def _get_basecamp_client ( self ) - > Optional [ BasecampClient ] :
""" Get authenticated Basecamp client. """
try :
token_data = token_storage . get_token ( )
logger . debug ( f " Token data retrieved: { token_data } " )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
if not token_data or not token_data . get ( ' access_token ' ) :
logger . error ( " No OAuth token available " )
return None
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
# Check if token is expired
if token_storage . is_token_expired ( ) :
logger . error ( " OAuth token has expired " )
return None
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
# Get account_id from token data first, then fall back to env var
account_id = token_data . get ( ' account_id ' ) or os . getenv ( ' BASECAMP_ACCOUNT_ID ' )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
# Set a default user agent if none is provided
user_agent = os . getenv ( ' USER_AGENT ' ) or " Basecamp MCP Server (cursor@example.com) "
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
if not account_id :
logger . error ( f " Missing account_id. Token data: { token_data } , Env BASECAMP_ACCOUNT_ID: { os . getenv ( ' BASECAMP_ACCOUNT_ID ' ) } " )
return None
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
logger . debug ( f " Creating Basecamp client with account_id: { account_id } , user_agent: { user_agent } " )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
return BasecampClient (
access_token = token_data [ ' access_token ' ] ,
account_id = account_id ,
user_agent = user_agent ,
auth_mode = ' oauth '
)
except Exception as e :
logger . error ( f " Error creating Basecamp client: { e } " )
return None
2025-06-06 10:23:50 +01:00
2025-06-29 08:22:09 +01:00
def handle_request ( self , request : Dict [ str , Any ] ) - > Optional [ Dict [ str , Any ] ] :
2025-06-02 17:11:39 +01:00
""" Handle an MCP request. """
method = request . get ( " method " )
# Normalize method name for cursor compatibility
method_lower = method . lower ( ) if isinstance ( method , str ) else ' '
params = request . get ( " params " , { } )
request_id = request . get ( " id " )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
logger . info ( f " Handling request: { method } " )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
try :
if method_lower == " initialize " :
return {
" jsonrpc " : " 2.0 " ,
" id " : request_id ,
" result " : {
" protocolVersion " : " 2024-11-05 " ,
" capabilities " : {
" tools " : { }
} ,
" serverInfo " : {
" name " : " basecamp-mcp-server " ,
" version " : " 1.0.0 "
}
}
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif method_lower == " initialized " :
# This is a notification, no response needed
logger . info ( " Received initialized notification " )
return None
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif method_lower in ( " tools/list " , " listtools " ) :
return {
" jsonrpc " : " 2.0 " ,
" id " : request_id ,
" result " : {
" tools " : self . tools
}
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif method_lower in ( " tools/call " , " toolscall " ) :
tool_name = params . get ( " name " )
arguments = params . get ( " arguments " , { } )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
result = self . _execute_tool ( tool_name , arguments )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
return {
" jsonrpc " : " 2.0 " ,
" id " : request_id ,
" result " : {
" content " : [
{
" type " : " text " ,
" text " : json . dumps ( result , indent = 2 )
}
]
}
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif method_lower in ( " listofferings " , " list_offerings " , " loffering " ) :
# Respond to Cursor's ListOfferings UI request
offerings = [ ]
for tool in self . tools :
offerings . append ( {
" name " : tool . get ( " name " ) ,
" displayName " : tool . get ( " name " ) ,
" description " : tool . get ( " description " )
} )
return {
" jsonrpc " : " 2.0 " ,
" id " : request_id ,
" result " : {
" offerings " : offerings
}
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif method_lower == " ping " :
# Handle ping requests
return {
" jsonrpc " : " 2.0 " ,
" id " : request_id ,
" result " : { }
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
else :
return {
" jsonrpc " : " 2.0 " ,
" id " : request_id ,
" error " : {
" code " : - 32601 ,
" message " : f " Method not found: { method } "
}
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
except Exception as e :
logger . error ( f " Error handling request: { e } " )
return {
" jsonrpc " : " 2.0 " ,
" id " : request_id ,
" error " : {
" code " : - 32603 ,
" message " : f " Internal error: { str ( e ) } "
}
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
def _execute_tool ( self , tool_name : str , arguments : Dict [ str , Any ] ) - > Dict [ str , Any ] :
""" Execute a tool and return the result. """
client = self . _get_basecamp_client ( )
if not client :
# Check if it's specifically a token expiration issue
if token_storage . is_token_expired ( ) :
return {
" error " : " OAuth token expired " ,
" message " : " Your Basecamp OAuth token has expired. Please re-authenticate by visiting http://localhost:8000 and completing the OAuth flow again. "
}
else :
return {
" error " : " Authentication required " ,
" message " : " Please authenticate with Basecamp first. Visit http://localhost:8000 to log in. "
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
try :
if tool_name == " get_projects " :
projects = client . get_projects ( )
return {
" status " : " success " ,
" projects " : projects ,
" count " : len ( projects )
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif tool_name == " get_project " :
project_id = arguments . get ( " project_id " )
project = client . get_project ( project_id )
return {
" status " : " success " ,
" project " : project
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif tool_name == " get_todolists " :
project_id = arguments . get ( " project_id " )
todolists = client . get_todolists ( project_id )
return {
" status " : " success " ,
" todolists " : todolists ,
" count " : len ( todolists )
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif tool_name == " get_todos " :
todolist_id = arguments . get ( " todolist_id " )
2025-06-05 18:51:36 +07:00
project_id = arguments . get ( " project_id " )
todos = client . get_todos ( project_id , todolist_id )
2025-06-02 17:11:39 +01:00
return {
" status " : " success " ,
" todos " : todos ,
" count " : len ( todos )
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif tool_name == " search_basecamp " :
query = arguments . get ( " query " )
project_id = arguments . get ( " project_id " )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
search = BasecampSearch ( client = client )
results = { }
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
if project_id :
# Search within specific project
results [ " todolists " ] = search . search_todolists ( query , project_id )
results [ " todos " ] = search . search_todos ( query , project_id )
else :
# Search across all projects
results [ " projects " ] = search . search_projects ( query )
results [ " todos " ] = search . search_todos ( query )
results [ " messages " ] = search . search_messages ( query )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
return {
" status " : " success " ,
" query " : query ,
2025-06-18 08:17:55 +01:00
" results " : results
}
elif tool_name == " global_search " :
query = arguments . get ( " query " )
search = BasecampSearch ( client = client )
results = search . global_search ( query )
return {
" status " : " success " ,
" query " : query ,
2025-06-02 17:11:39 +01:00
" results " : results
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif tool_name == " get_comments " :
recording_id = arguments . get ( " recording_id " )
2025-06-05 18:51:36 +07:00
project_id = arguments . get ( " project_id " )
comments = client . get_comments ( project_id , recording_id )
2025-06-02 17:11:39 +01:00
return {
" status " : " success " ,
" comments " : comments ,
" count " : len ( comments )
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
elif tool_name == " get_campfire_lines " :
project_id = arguments . get ( " project_id " )
campfire_id = arguments . get ( " campfire_id " )
lines = client . get_campfire_lines ( project_id , campfire_id )
return {
" status " : " success " ,
" campfire_lines " : lines ,
" count " : len ( lines )
}
2025-06-05 18:51:36 +07:00
elif tool_name == " get_daily_check_ins " :
project_id = arguments . get ( " project_id " )
2025-06-29 08:22:09 +01:00
page = arguments . get ( " page " , 1 )
if page is not None and not isinstance ( page , int ) :
page = 1
2025-06-05 18:51:36 +07:00
answers = client . get_daily_check_ins ( project_id , page = page )
return {
" status " : " success " ,
" campfire_lines " : answers ,
" count " : len ( answers )
}
elif tool_name == " get_question_answers " :
project_id = arguments . get ( " project_id " )
question_id = arguments . get ( " question_id " )
2025-06-29 08:22:09 +01:00
page = arguments . get ( " page " , 1 )
if page is not None and not isinstance ( page , int ) :
page = 1
2025-06-05 18:51:36 +07:00
answers = client . get_question_answers ( project_id , question_id , page = page )
return {
" status " : " success " ,
" campfire_lines " : answers ,
" count " : len ( answers )
}
2025-06-02 17:11:39 +01:00
2025-06-26 22:34:01 +01:00
# Card Table tools implementation
2025-06-29 08:22:09 +01:00
elif tool_name == " get_card_tables " :
project_id = arguments . get ( " project_id " )
card_tables = client . get_card_tables ( project_id )
return {
" status " : " success " ,
" card_tables " : card_tables ,
" count " : len ( card_tables )
}
2025-06-26 22:34:01 +01:00
elif tool_name == " get_card_table " :
project_id = arguments . get ( " project_id " )
try :
2025-06-29 08:22:09 +01:00
# First, let's see what card tables we find
card_tables = client . get_card_tables ( project_id )
if not card_tables :
return {
" status " : " error " ,
" message " : " No card tables found in project " ,
" debug " : f " Found { len ( card_tables ) } card tables "
}
card_table = card_tables [ 0 ] # Get the first card table
# Get the full details
2025-06-26 22:34:01 +01:00
card_table_details = client . get_card_table_details ( project_id , card_table [ ' id ' ] )
return {
" status " : " success " ,
2025-06-29 08:22:09 +01:00
" card_table " : card_table_details ,
" debug " : f " Found { len ( card_tables ) } card tables, using first one with ID { card_table [ ' id ' ] } "
2025-06-26 22:34:01 +01:00
}
except Exception as e :
2025-06-29 08:22:09 +01:00
error_msg = str ( e )
return {
" status " : " error " ,
" message " : f " Error getting card table: { error_msg } " ,
" debug " : error_msg
}
2025-06-26 22:34:01 +01:00
elif tool_name == " get_columns " :
project_id = arguments . get ( " project_id " )
card_table_id = arguments . get ( " card_table_id " )
columns = client . get_columns ( project_id , card_table_id )
return {
" status " : " success " ,
" columns " : columns ,
" count " : len ( columns )
}
elif tool_name == " get_column " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
column = client . get_column ( project_id , column_id )
return {
" status " : " success " ,
" column " : column
}
elif tool_name == " create_column " :
project_id = arguments . get ( " project_id " )
card_table_id = arguments . get ( " card_table_id " )
title = arguments . get ( " title " )
column = client . create_column ( project_id , card_table_id , title )
return {
" status " : " success " ,
" column " : column ,
" message " : f " Column ' { title } ' created successfully "
}
elif tool_name == " update_column " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
title = arguments . get ( " title " )
column = client . update_column ( project_id , column_id , title )
return {
" status " : " success " ,
" column " : column ,
2025-06-29 08:37:41 +01:00
" message " : " Column updated successfully "
2025-06-26 22:34:01 +01:00
}
elif tool_name == " move_column " :
project_id = arguments . get ( " project_id " )
2025-06-29 08:37:41 +01:00
card_table_id = arguments . get ( " card_table_id " )
2025-06-26 22:34:01 +01:00
column_id = arguments . get ( " column_id " )
position = arguments . get ( " position " )
2025-06-29 08:22:09 +01:00
client . move_column ( project_id , column_id , position , card_table_id )
2025-06-26 22:34:01 +01:00
return {
" status " : " success " ,
" message " : f " Column moved to position { position } "
}
elif tool_name == " update_column_color " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
color = arguments . get ( " color " )
column = client . update_column_color ( project_id , column_id , color )
return {
" status " : " success " ,
" column " : column ,
" message " : f " Column color updated to { color } "
}
elif tool_name == " put_column_on_hold " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
client . put_column_on_hold ( project_id , column_id )
return {
" status " : " success " ,
" message " : " Column put on hold "
}
elif tool_name == " remove_column_hold " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
client . remove_column_hold ( project_id , column_id )
return {
" status " : " success " ,
" message " : " Column hold removed "
}
elif tool_name == " watch_column " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
client . watch_column ( project_id , column_id )
return {
" status " : " success " ,
" message " : " Column notifications enabled "
}
elif tool_name == " unwatch_column " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
client . unwatch_column ( project_id , column_id )
return {
" status " : " success " ,
" message " : " Column notifications disabled "
}
elif tool_name == " get_cards " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
cards = client . get_cards ( project_id , column_id )
return {
" status " : " success " ,
" cards " : cards ,
" count " : len ( cards )
}
elif tool_name == " get_card " :
project_id = arguments . get ( " project_id " )
card_id = arguments . get ( " card_id " )
card = client . get_card ( project_id , card_id )
return {
" status " : " success " ,
" card " : card
}
elif tool_name == " create_card " :
project_id = arguments . get ( " project_id " )
column_id = arguments . get ( " column_id " )
title = arguments . get ( " title " )
content = arguments . get ( " content " )
2025-06-29 08:22:09 +01:00
due_on = arguments . get ( " due_on " )
notify = bool ( arguments . get ( " notify " , False ) )
card = client . create_card ( project_id , column_id , title , content , due_on , notify )
2025-06-26 22:34:01 +01:00
return {
" status " : " success " ,
" card " : card ,
" message " : f " Card ' { title } ' created successfully "
}
elif tool_name == " update_card " :
project_id = arguments . get ( " project_id " )
card_id = arguments . get ( " card_id " )
title = arguments . get ( " title " )
content = arguments . get ( " content " )
2025-06-29 08:22:09 +01:00
due_on = arguments . get ( " due_on " )
assignee_ids = arguments . get ( " assignee_ids " )
card = client . update_card ( project_id , card_id , title , content , due_on , assignee_ids )
2025-06-26 22:34:01 +01:00
return {
" status " : " success " ,
" card " : card ,
" message " : " Card updated successfully "
}
elif tool_name == " move_card " :
project_id = arguments . get ( " project_id " )
card_id = arguments . get ( " card_id " )
column_id = arguments . get ( " column_id " )
2025-06-29 08:22:09 +01:00
client . move_card ( project_id , card_id , column_id )
2025-06-26 22:34:01 +01:00
message = " Card moved "
2025-06-29 08:22:09 +01:00
if column_id :
2025-06-26 22:34:01 +01:00
message = f " Card moved to column { column_id } "
return {
" status " : " success " ,
" message " : message
}
2025-06-29 08:22:09 +01:00
elif tool_name == " complete_card " :
project_id = arguments . get ( " project_id " )
card_id = arguments . get ( " card_id " )
client . complete_card ( project_id , card_id )
return {
" status " : " success " ,
" message " : " Card marked as complete "
}
elif tool_name == " uncomplete_card " :
project_id = arguments . get ( " project_id " )
card_id = arguments . get ( " card_id " )
client . uncomplete_card ( project_id , card_id )
return {
" status " : " success " ,
" message " : " Card marked as incomplete "
}
elif tool_name == " get_card_steps " :
project_id = arguments . get ( " project_id " )
card_id = arguments . get ( " card_id " )
steps = client . get_card_steps ( project_id , card_id )
return {
" status " : " success " ,
" steps " : steps ,
" count " : len ( steps )
}
elif tool_name == " create_card_step " :
project_id = arguments . get ( " project_id " )
card_id = arguments . get ( " card_id " )
title = arguments . get ( " title " )
due_on = arguments . get ( " due_on " )
assignee_ids = arguments . get ( " assignee_ids " )
step = client . create_card_step ( project_id , card_id , title , due_on , assignee_ids )
return {
" status " : " success " ,
" step " : step ,
" message " : f " Step ' { title } ' created successfully "
}
elif tool_name == " get_card_step " :
project_id = arguments . get ( " project_id " )
step_id = arguments . get ( " step_id " )
step = client . get_card_step ( project_id , step_id )
return {
" status " : " success " ,
" step " : step
}
elif tool_name == " update_card_step " :
project_id = arguments . get ( " project_id " )
step_id = arguments . get ( " step_id " )
title = arguments . get ( " title " )
due_on = arguments . get ( " due_on " )
assignee_ids = arguments . get ( " assignee_ids " )
step = client . update_card_step ( project_id , step_id , title , due_on , assignee_ids )
return {
" status " : " success " ,
" step " : step ,
" message " : f " Step ' { title } ' updated successfully "
}
elif tool_name == " delete_card_step " :
project_id = arguments . get ( " project_id " )
step_id = arguments . get ( " step_id " )
client . delete_card_step ( project_id , step_id )
return {
" status " : " success " ,
" message " : " Step deleted successfully "
}
elif tool_name == " complete_card_step " :
project_id = arguments . get ( " project_id " )
step_id = arguments . get ( " step_id " )
client . complete_card_step ( project_id , step_id )
return {
" status " : " success " ,
" message " : " Step marked as complete "
}
elif tool_name == " uncomplete_card_step " :
project_id = arguments . get ( " project_id " )
step_id = arguments . get ( " step_id " )
client . uncomplete_card_step ( project_id , step_id )
return {
" status " : " success " ,
" message " : " Step marked as incomplete "
}
2025-06-02 17:11:39 +01:00
else :
return {
" error " : " Unknown tool " ,
" message " : f " Tool ' { tool_name } ' is not supported "
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
except Exception as e :
logger . error ( f " Error executing tool { tool_name } : { e } " )
# Check if it's a 401 error (token expired during API call)
if " 401 " in str ( e ) and " expired " in str ( e ) . lower ( ) :
return {
" error " : " OAuth token expired " ,
" message " : " Your Basecamp OAuth token expired during the API call. Please re-authenticate by visiting http://localhost:8000 and completing the OAuth flow again. "
}
return {
" error " : " Execution error " ,
" message " : str ( e )
}
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
def run ( self ) :
""" Run the MCP server, reading from stdin and writing to stdout. """
logger . info ( " Starting MCP CLI server " )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
for line in sys . stdin :
try :
line = line . strip ( )
if not line :
continue
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
request = json . loads ( line )
response = self . handle_request ( request )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
# Write response to stdout (only if there's a response)
if response is not None :
print ( json . dumps ( response ) , flush = True )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
except json . JSONDecodeError as e :
logger . error ( f " Invalid JSON received: { e } " )
error_response = {
" jsonrpc " : " 2.0 " ,
" id " : None ,
" error " : {
" code " : - 32700 ,
" message " : " Parse error "
}
}
print ( json . dumps ( error_response ) , flush = True )
2025-06-06 10:23:50 +01:00
2025-06-02 17:11:39 +01:00
except Exception as e :
logger . error ( f " Unexpected error: { e } " )
error_response = {
2025-06-06 10:23:50 +01:00
" jsonrpc " : " 2.0 " ,
2025-06-02 17:11:39 +01:00
" id " : None ,
" error " : {
" code " : - 32603 ,
" message " : f " Internal error: { str ( e ) } "
}
}
print ( json . dumps ( error_response ) , flush = True )
if __name__ == " __main__ " :
server = MCPServer ( )
2025-06-06 10:23:50 +01:00
server . run ( )
