mcp-server-moscow 0.0.2 → 0.0.4

package/README.dev.md

@@ -15,6 +15,8 @@ The server requires the following environment variables. You can set them in a `
 
 - `SUPABASE_URL`: The URL of your Supabase project.
 - `MCP_TOKEN` (Optional): A custom token for authorization if your Edge Functions require it.
+- `TOPIC` (Optional): Default topic for filtering tasks.
+- `BOARD_ID` (Optional): Default board ID for filtering and assigning tasks.
 
 ## Usage
 
@@ -34,7 +36,8 @@ Add the following to your MCP configuration file (e.g., `claude_desktop_config.j
       "env": {
       "SUPABASE_URL": "https://your-project.supabase.co",
         "MCP_TOKEN": "mcp_123.....",
-        "TOPIC": "mcp"
+        "TOPIC": "mcp",
+        "BOARD_ID": "your-board-uuid"
       },
       "disabled": false
     }
@@ -75,7 +78,10 @@ npx -y moscow-mcp-server
 
 ## Tools Provided
 
-- `list_tasks`: List tasks from the Moscow project. Can be filtered by `topic`.
-- `create_task`: Create a new task.
-- `update_task`: Update an existing task.
+- `list_tasks`: List tasks from the Moscow project. Can be filtered by `topic` or `board_id`.
+- `create_task`: Create a new task. Supports `board_id` to assign to a board.
+- `update_task`: Update an existing task. Supports `board_id` to move between boards.
 - `delete_task`: Delete a task.
+- `find_task`: Find a task by ID or name. Supports `board_id` filtering.
+- `list_boards`: List all boards for the current user.
+

package/dist/index.js

@@ -12,6 +12,7 @@ const __dirname = path.dirname(__filename);
 dotenv.config({ path: path.resolve(__dirname, '../.env') });
 const SUPABASE_URL = process.env.SUPABASE_URL || 'https://jnxbtfiwzaxwheifuhuf.supabase.co';
 const DEFAULT_TOPIC = process.env.TOPIC || 'default';
+const DEFAULT_BOARD_ID = process.env.BOARD_ID || undefined;
 if (!SUPABASE_URL) {
     console.error('Missing SUPABASE_URL environment variable');
     process.exit(1);
@@ -25,12 +26,13 @@ const server = new Server({
     },
 });
 const getEdgeFunctionUrl = () => `${SUPABASE_URL}/functions/v1/tasks`;
+const getBoardsEdgeFunctionUrl = () => `${SUPABASE_URL}/functions/v1/boards`;
 // Tool Handlers
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
             name: 'list_tasks',
-            description: 'List tasks for the current user and optionally filter by topic.',
+            description: 'List tasks for the current user and optionally filter by topic or board.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -38,6 +40,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         type: 'string',
                         description: 'Optional topic to filter tasks by.',
                     },
+                    board_id: {
+                        type: 'string',
+                        description: 'Optional board ID to filter tasks by. Only tasks belonging to this board will be returned.',
+                    },
                 },
             },
         },
@@ -69,6 +75,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         enum: ['TODO', 'IN_PROGRESS', 'DONE'],
                         description: 'The status of the task.',
                     },
+                    board_id: {
+                        type: 'string',
+                        description: 'Optional board ID to assign the task to.',
+                    },
                 },
                 required: ['title'],
             },
@@ -105,6 +115,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         enum: ['TODO', 'IN_PROGRESS', 'DONE'],
                         description: 'The new status.',
                     },
+                    board_id: {
+                        type: 'string',
+                        description: 'Move the task to a different board by providing the new board ID.',
+                    },
                 },
                 required: ['id'],
             },
@@ -141,9 +155,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         type: 'string',
                         description: 'Optional topic to narrow down the search scope.',
                     },
+                    board_id: {
+                        type: 'string',
+                        description: 'Optional board ID to narrow down the search scope.',
+                    },
                 },
             },
         },
+        {
+            name: 'list_boards',
+            description: 'List all boards for the current user. Useful for discovering available board IDs to filter or assign tasks.',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
@@ -151,12 +177,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     const env = extra?.env || {};
     const mcpToken = env.MCP_TOKEN || process.env.MCP_TOKEN;
     const topicScope = request.params.arguments?.topic || env.TOPIC || DEFAULT_TOPIC;
+    // Board from env takes priority (locks MCP to single board), otherwise use request arg or default
+    const envBoardId = env.BOARD_ID || DEFAULT_BOARD_ID;
+    const boardScope = envBoardId || request.params.arguments?.board_id;
     const authValue = mcpToken;
     switch (request.params.name) {
         case 'list_tasks': {
             try {
+                const params = {};
+                // Only filter by topic if explicitly provided (not using default)
+                const explicitTopic = request.params.arguments?.topic || env.TOPIC;
+                if (explicitTopic) {
+                    params.topic = explicitTopic;
+                }
+                if (boardScope) {
+                    params.board_id = boardScope;
+                }
                 const response = await axios.get(getEdgeFunctionUrl(), {
-                    params: { topic: topicScope },
+                    params,
                     headers: {
                         Authorization: `Bearer ${authValue}`,
                     },
@@ -178,7 +216,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
             }
         }
         case 'create_task': {
-            const { title, description, topic, priority, status } = request.params.arguments || {};
+            const { title, description, topic, priority, status, board_id } = request.params.arguments || {};
+            // Use env board if locked, otherwise use provided board_id
+            const taskBoardId = envBoardId || board_id || null;
             try {
                 const response = await axios.post(getEdgeFunctionUrl(), {
                     title,
@@ -186,6 +226,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
                     topic: topic || topicScope,
                     priority,
                     status,
+                    board_id: taskBoardId,
                 }, {
                     headers: {
                         Authorization: `Bearer ${authValue}`,
@@ -270,7 +311,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
             }
         }
         case 'find_task': {
-            const { id, name, topic } = request.params.arguments ||
+            const { id, name, topic, board_id } = request.params.arguments ||
                 {};
             if (!id && !name) {
                 return {
@@ -287,6 +328,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
                         ...(id && { id }),
                         ...(name && { name }),
                         ...(topic && { topic }),
+                        ...(board_id && { board_id }),
                     },
                     headers: {
                         Authorization: `Bearer ${authValue}`,
@@ -324,6 +366,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
                 };
             }
         }
+        case 'list_boards': {
+            try {
+                const response = await axios.get(getBoardsEdgeFunctionUrl(), {
+                    headers: {
+                        Authorization: `Bearer ${authValue}`,
+                    },
+                });
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
+                };
+            }
+            catch (error) {
+                const errorMessage = axios.isAxiosError(error)
+                    ? error.response?.data?.error || error.message
+                    : error instanceof Error
+                        ? error.message
+                        : String(error);
+                return {
+                    content: [{ type: 'text', text: `Error listing boards: ${errorMessage}` }],
+                    isError: true,
+                };
+            }
+        }
         default:
             throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-moscow",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "MCP for Moscow task management",
   "main": "dist/index.js",