@mseep/mcp-agent-social 1.1.0

package/dist/validation.js

@@ -0,0 +1,223 @@
+// ABOUTME: JSON Schema validation utilities for MCP tools
+// ABOUTME: Provides runtime validation for tool inputs
+export class ValidationResult {
+    isValid;
+    errors;
+    data;
+    constructor(isValid, errors = [], data) {
+        this.isValid = isValid;
+        this.errors = errors;
+        this.data = data;
+    }
+    static success(data) {
+        return new ValidationResult(true, [], data);
+    }
+    static failure(errors) {
+        return new ValidationResult(false, errors);
+    }
+}
+export function validateString(value, field, options = {}) {
+    const errors = [];
+    if (options.required && (value === undefined || value === null)) {
+        if (field === 'content') {
+            errors.push({ field, message: 'Content must not be empty' });
+        }
+        else {
+            errors.push({ field, message: `${field} is required` });
+        }
+        return errors;
+    }
+    if (value !== undefined && value !== null) {
+        if (typeof value !== 'string') {
+            errors.push({ field, message: `${field} must be a string` });
+            return errors;
+        }
+        // For content validation, check if trimmed string is empty
+        if (field === 'content' && options.required && value.trim().length === 0) {
+            errors.push({ field, message: 'Content must not be empty' });
+            return errors;
+        }
+        if (options.minLength && value.length < options.minLength) {
+            if (field === 'content') {
+                errors.push({ field, message: 'Content must not be empty' });
+            }
+            else {
+                errors.push({
+                    field,
+                    message: `${field} must be at least ${options.minLength} characters`,
+                });
+            }
+        }
+        if (options.maxLength && value.length > options.maxLength) {
+            errors.push({ field, message: `${field} must be at most ${options.maxLength} characters` });
+        }
+    }
+    return errors;
+}
+export function validateNumber(value, field, options = {}) {
+    const errors = [];
+    if (options.required && (value === undefined || value === null)) {
+        errors.push({ field, message: `${field} is required` });
+        return errors;
+    }
+    if (value !== undefined && value !== null) {
+        if (typeof value !== 'number' || Number.isNaN(value)) {
+            errors.push({ field, message: `${field} must be a number` });
+            return errors;
+        }
+        if (options.min !== undefined && value < options.min) {
+            errors.push({ field, message: `${field} must be at least ${options.min}` });
+        }
+        if (options.max !== undefined && value > options.max) {
+            errors.push({ field, message: `${field} must be at most ${options.max}` });
+        }
+    }
+    return errors;
+}
+export function validateArray(value, field, options = {}) {
+    const errors = [];
+    if (options.required && (value === undefined || value === null)) {
+        errors.push({ field, message: `${field} is required` });
+        return errors;
+    }
+    if (value !== undefined && value !== null) {
+        if (!Array.isArray(value)) {
+            errors.push({ field, message: `${field} must be an array` });
+            return errors;
+        }
+        if (options.itemValidator) {
+            value.forEach((item, index) => {
+                const itemErrors = options.itemValidator?.(item, index);
+                if (itemErrors) {
+                    errors.push(...itemErrors.map((err) => ({
+                        field: `${field}[${index}].${err.field}`,
+                        message: err.message,
+                    })));
+                }
+            });
+        }
+    }
+    return errors;
+}
+// Helper to trim string values consistently
+function trimStringValue(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    // Only accept primitive types that can be meaningfully converted to strings
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    // Reject objects, arrays, functions, etc.
+    return undefined;
+}
+// Login tool validation
+export function validateLoginInput(input) {
+    const errors = [];
+    // Special handling for agent_name
+    if (input.agent_name === undefined || input.agent_name === null) {
+        errors.push({ field: 'agent_name', message: 'Agent name must not be empty' });
+    }
+    else if (typeof input.agent_name !== 'string') {
+        errors.push({ field: 'agent_name', message: 'Agent name must be a string' });
+    }
+    else if (input.agent_name.trim().length === 0) {
+        errors.push({ field: 'agent_name', message: 'Agent name must not be empty' });
+    }
+    if (errors.length > 0) {
+        return ValidationResult.failure(errors);
+    }
+    const agentName = trimStringValue(input.agent_name);
+    if (!agentName) {
+        return ValidationResult.failure([
+            { field: 'agent_name', message: 'Agent name cannot be empty' },
+        ]);
+    }
+    return ValidationResult.success({
+        agent_name: agentName,
+    });
+}
+// Read posts tool validation
+export function validateReadPostsInput(input) {
+    const errors = [];
+    // Parse and validate numeric values
+    const limit = typeof input.limit === 'number'
+        ? input.limit
+        : typeof input.limit === 'string'
+            ? Number.parseInt(input.limit, 10)
+            : 10;
+    const offset = typeof input.offset === 'number'
+        ? input.offset
+        : typeof input.offset === 'string'
+            ? Number.parseInt(input.offset, 10)
+            : 0;
+    // Apply defaults and trim string values
+    const data = {
+        limit: Number.isNaN(limit) ? 10 : limit,
+        offset: Number.isNaN(offset) ? 0 : offset,
+        agent_filter: trimStringValue(input.agent_filter),
+        tag_filter: trimStringValue(input.tag_filter),
+        thread_id: trimStringValue(input.thread_id),
+    };
+    errors.push(...validateNumber(data.limit, 'limit', { min: 1, max: 100 }));
+    errors.push(...validateNumber(data.offset, 'offset', { min: 0 }));
+    // Check for empty string filters (before trimming converted them to undefined)
+    if (input.agent_filter !== undefined &&
+        input.agent_filter !== null &&
+        typeof input.agent_filter === 'string' &&
+        input.agent_filter.trim() === '') {
+        errors.push({ field: 'agent_filter', message: 'agent_filter cannot be empty' });
+    }
+    if (input.tag_filter !== undefined &&
+        input.tag_filter !== null &&
+        typeof input.tag_filter === 'string' &&
+        input.tag_filter.trim() === '') {
+        errors.push({ field: 'tag_filter', message: 'tag_filter cannot be empty' });
+    }
+    if (input.thread_id !== undefined &&
+        input.thread_id !== null &&
+        typeof input.thread_id === 'string' &&
+        input.thread_id.trim() === '') {
+        errors.push({ field: 'thread_id', message: 'thread_id cannot be empty' });
+    }
+    if (errors.length > 0) {
+        return ValidationResult.failure(errors);
+    }
+    return ValidationResult.success(data);
+}
+// Create post tool validation
+export function validateCreatePostInput(input) {
+    const errors = [];
+    errors.push(...validateString(input.content, 'content', {
+        required: true,
+        minLength: 1,
+    }));
+    errors.push(...validateString(input.parent_post_id, 'parent_post_id'));
+    if (input.tags !== undefined) {
+        errors.push(...validateArray(input.tags, 'tags', {
+            itemValidator: (item, _index) => validateString(item, 'item', {}),
+        }));
+    }
+    if (errors.length > 0) {
+        return ValidationResult.failure(errors);
+    }
+    // Filter and trim tags consistently
+    const rawTags = Array.isArray(input.tags) ? input.tags : [];
+    const filteredTags = rawTags
+        .map((tag) => trimStringValue(tag))
+        .filter((tag) => tag !== undefined);
+    const content = trimStringValue(input.content);
+    if (!content) {
+        return ValidationResult.failure([{ field: 'content', message: 'Content cannot be empty' }]);
+    }
+    return ValidationResult.success({
+        content,
+        tags: filteredTags,
+        parent_post_id: trimStringValue(input.parent_post_id),
+    });
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@mseep/mcp-agent-social",
+  "version": "1.1.0",
+  "description": "MCP server for agent social media platform",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-agent-social": "./bin/mcp-agent-social"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules\" jest",
+    "test:coverage": "NODE_ENV=test NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage",
+    "test:watch": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watch",
+    "test:integration": "./scripts/test-mcp-integration.sh",
+    "test:mcp-sse": "NODE_OPTIONS=\"--experimental-vm-modules\" jest tests/integration/mcp-sse-mocked.test.ts",
+    "test:mcp-sse:old": "NODE_OPTIONS=\"--experimental-vm-modules\" jest tests/integration/mcp-sse.test.ts",
+    "test:mcp-sse:full": "TEST_SERVER_AUTO_START=true NODE_OPTIONS=\"--experimental-vm-modules\" jest tests/integration/mcp-sse.test.ts",
+    "start:http": "MCP_TRANSPORT=http MCP_HTTP_PORT=3000 npm start",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "typecheck": "tsc --noEmit",
+    "mcp-probe": "./scripts/mcp-probe-tests.sh",
+    "mcp-probe:validate": "mcp-probe validate --stdio 'node' --args 'dist/index.js' --working-dir '$PWD'",
+    "mcp-probe:ci": "node scripts/ci-mcp-test.js",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "social-media",
+    "agents",
+    "mseep",
+    "mcp-server"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/2389-research/mcp-socialmedia.git"
+  },
+  "type": "module",
+  "files": [
+    "dist/",
+    "bin/",
+    "src/",
+    "tsconfig.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@types/node-fetch": "^2.6.12",
+    "dotenv": "^16.5.0",
+    "node-fetch": "^3.3.2",
+    "typescript": "^5.8.3",
+    "zod": "^3.25.49"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.15.29",
+    "jest": "^29.7.0",
+    "jest-junit": "^16.0.0",
+    "ts-jest": "^29.3.4",
+    "tsx": "^4.19.4"
+  },
+  "publisher": "mseep"
+}

package/src/api-client.ts

@@ -0,0 +1,292 @@
+// ABOUTME: HTTP client for communicating with the external social media API
+// ABOUTME: Handles authentication, error handling, and typed responses
+
+import fetch, { type RequestInit, type Response } from 'node-fetch';
+
+// Type for the fetch function to enable mocking in tests
+export type FetchFunction = typeof fetch;
+import { config } from './config.js';
+import { logger } from './logger.js';
+import {
+  McpAuthenticationError,
+  McpMethodNotFoundError,
+  McpRateLimitError,
+  McpTimeoutError,
+} from './middleware/error-handler.js';
+import type { PostData, PostQueryOptions, PostResponse, PostsResponse } from './types.js';
+
+// Remote API response types
+interface RemotePost {
+  postId: string;
+  author: string;
+  content: string;
+  tags?: string[];
+  createdAt?: {
+    _seconds: number;
+  };
+  parentPostId?: string;
+}
+
+interface RemotePostsResponse {
+  posts: RemotePost[];
+  totalCount: number;
+  nextOffset?: string;
+}
+
+interface RemotePostResponse {
+  postId: string;
+  author: string;
+  content: string;
+  tags?: string[];
+  createdAt?: {
+    _seconds: number;
+  };
+  parentPostId?: string;
+}
+
+export interface IApiClient {
+  fetchPosts(teamName: string, options?: PostQueryOptions): Promise<PostsResponse>;
+  createPost(teamName: string, postData: PostData): Promise<PostResponse>;
+}
+
+export class ApiClient implements IApiClient {
+  private baseUrl: string;
+  private apiKey: string;
+  private timeout: number;
+  private fetchFn: FetchFunction;
+
+  constructor(
+    baseUrl: string = config.socialApiBaseUrl,
+    apiKey: string = config.socialApiKey,
+    timeout: number = config.apiTimeout,
+    fetchFn: FetchFunction = fetch,
+  ) {
+    this.baseUrl = baseUrl.replace(/\/$/, ''); // Remove trailing slash
+    this.apiKey = apiKey;
+    this.timeout = timeout;
+    this.fetchFn = fetchFn;
+
+    logger.debug('ApiClient initialized', {
+      baseUrl: this.baseUrl,
+      timeout: this.timeout,
+      hasApiKey: !!this.apiKey,
+    });
+  }
+
+  /**
+   * Fetch posts from the API
+   */
+  async fetchPosts(teamName: string, options?: PostQueryOptions): Promise<PostsResponse> {
+    const params = new URLSearchParams();
+
+    if (options?.limit !== undefined) {
+      params.append('limit', options.limit.toString());
+    }
+    // Remote API uses cursor-based pagination, not numeric offset
+    // For now, we'll ignore the offset parameter since the remote API doesn't support it
+    // TODO: Implement proper cursor-based pagination mapping
+    // Note: remote API may not support agent/tag filters - these params might be ignored
+    if (options?.agent_filter) {
+      params.append('agent', options.agent_filter);
+    }
+    if (options?.tag_filter) {
+      params.append('tag', options.tag_filter);
+    }
+    if (options?.thread_id) {
+      params.append('thread_id', options.thread_id);
+    }
+
+    const queryString = params.toString();
+    const url = `${this.baseUrl}/teams/${encodeURIComponent(teamName)}/posts${
+      queryString ? `?${queryString}` : ''
+    }`;
+
+    logger.debug('Fetching posts', {
+      teamName,
+      queryParams: Object.fromEntries(params),
+      url,
+    });
+
+    const response = await this.makeRequest('GET', url);
+    const remoteResponse = response as RemotePostsResponse;
+
+    // Validate remote response
+    if (!remoteResponse.posts || !Array.isArray(remoteResponse.posts)) {
+      throw new Error('Invalid API response: posts array missing or malformed');
+    }
+
+    // Adapt remote response to our schema
+    const adaptedPosts = remoteResponse.posts
+      .filter((post: RemotePost) => {
+        if (!post.postId || !post.author || !post.content) {
+          logger.warn('Skipping malformed post', { post });
+          return false;
+        }
+        return true;
+      })
+      .map((post: RemotePost) => ({
+        id: post.postId,
+        author_name: post.author,
+        content: post.content,
+        tags: post.tags || [],
+        timestamp: post.createdAt?._seconds
+          ? new Date(post.createdAt._seconds * 1000).toISOString()
+          : new Date().toISOString(),
+        parent_post_id: post.parentPostId || undefined,
+        team_name: teamName,
+      }));
+
+    const adaptedResponse: PostsResponse = {
+      posts: adaptedPosts,
+      total: adaptedPosts.length, // Remote API doesn't provide total, estimate from current page
+      has_more: Boolean(remoteResponse.nextOffset),
+    };
+
+    return adaptedResponse;
+  }
+
+  /**
+   * Create a new post
+   */
+  async createPost(teamName: string, postData: PostData): Promise<PostResponse> {
+    const url = `${this.baseUrl}/teams/${encodeURIComponent(teamName)}/posts`;
+
+    logger.debug('Creating post', {
+      teamName,
+      url,
+      hasContent: !!postData.content,
+      tagsCount: postData.tags?.length || 0,
+    });
+
+    // Adapt to remote API schema - use 'author' instead of 'author_name'
+    const remotePostData = {
+      author: postData.author_name,
+      content: postData.content,
+      tags: postData.tags,
+      parentPostId: postData.parent_post_id,
+    };
+
+    const response = await this.makeRequest('POST', url, remotePostData);
+    const remoteResponse = response as RemotePostResponse;
+
+    // Adapt remote response back to our schema
+    const adaptedResponse: PostResponse = {
+      post: {
+        id: remoteResponse.postId,
+        author_name: remoteResponse.author,
+        content: remoteResponse.content,
+        tags: remoteResponse.tags || [],
+        timestamp: remoteResponse.createdAt?._seconds
+          ? new Date(remoteResponse.createdAt._seconds * 1000).toISOString()
+          : new Date().toISOString(),
+        parent_post_id: remoteResponse.parentPostId || undefined,
+        team_name: teamName,
+      },
+    };
+
+    return adaptedResponse;
+  }
+
+  /**
+   * Make an HTTP request with error handling and logging
+   */
+  private async makeRequest(method: string, url: string, body?: unknown): Promise<unknown> {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    const startTime = Date.now();
+
+    try {
+      const options: RequestInit = {
+        method,
+        headers: {
+          'x-api-key': this.apiKey,
+          'Content-Type': 'application/json',
+          Accept: 'application/json',
+        },
+        signal: controller.signal,
+      };
+
+      if (body) {
+        options.body = JSON.stringify(body);
+      }
+
+      logger.apiRequest(method, url, {
+        headers: {
+          'Content-Type': 'application/json',
+          Accept: 'application/json',
+        },
+        hasBody: !!body,
+        timeout: this.timeout,
+      });
+
+      const response = await this.fetchFn(url, options);
+      const duration = Date.now() - startTime;
+
+      if (!response.ok) {
+        logger.apiResponse(method, url, response.status, duration, {
+          statusText: response.statusText,
+          failed: true,
+        });
+        throw await this.handleErrorResponse(response);
+      }
+
+      logger.apiResponse(method, url, response.status, duration);
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      const duration = Date.now() - startTime;
+      if (error instanceof Error && error.name === 'AbortError') {
+        logger.apiError(method, url, new Error(`Request timeout after ${this.timeout}ms`), {
+          duration,
+          timeout: true,
+        });
+        throw new McpTimeoutError(`Request timeout after ${this.timeout}ms`, this.timeout);
+      }
+      logger.apiError(method, url, error instanceof Error ? error : new Error(String(error)), {
+        duration,
+        errorType: error instanceof Error ? error.name : 'unknown',
+      });
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+
+  /**
+   * Handle error responses from the API
+   */
+  private async handleErrorResponse(response: Response): Promise<Error> {
+    let errorMessage = `API request failed: ${response.status} ${response.statusText}`;
+
+    try {
+      const errorData = (await response.json()) as {
+        error?: string;
+        message?: string;
+        code?: string;
+      };
+      errorMessage = errorData.error || errorData.message || errorMessage;
+    } catch {
+      // Ignore JSON parse errors
+    }
+
+    // Error handled, no logging needed for production
+
+    switch (response.status) {
+      case 401:
+        throw new McpAuthenticationError(`Authentication failed: ${errorMessage}`);
+      case 403:
+        throw new Error(`Access forbidden: ${errorMessage}`);
+      case 404:
+        throw new McpMethodNotFoundError(`Resource not found: ${errorMessage}`);
+      case 429:
+        throw new McpRateLimitError(`Rate limit exceeded: ${errorMessage}`);
+      case 500:
+      case 502:
+      case 503:
+      case 504:
+        throw new Error(`Server error: ${errorMessage}`);
+      default:
+        throw new Error(errorMessage);
+    }
+  }
+}

package/src/config.ts

@@ -0,0 +1,92 @@
+// ABOUTME: Configuration management for the MCP server
+// ABOUTME: Loads and validates environment variables
+
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { config as loadDotenv } from 'dotenv';
+import type { ServerConfig } from './types.js';
+
+loadDotenv();
+
+// Centralized configuration keys - single source of truth
+export const ENV_KEYS = {
+  SOCIALMEDIA_API_BASE_URL: 'SOCIALMEDIA_API_BASE_URL',
+  SOCIALMEDIA_API_KEY: 'SOCIALMEDIA_API_KEY',
+  SOCIALMEDIA_TEAM_ID: 'SOCIALMEDIA_TEAM_ID',
+  PORT: 'PORT',
+  LOG_LEVEL: 'LOG_LEVEL',
+  API_TIMEOUT: 'API_TIMEOUT',
+  MCP_TRANSPORT: 'MCP_TRANSPORT',
+  MCP_HTTP_PORT: 'MCP_HTTP_PORT',
+  MCP_HTTP_HOST: 'MCP_HTTP_HOST',
+  MCP_ENABLE_JSON: 'MCP_ENABLE_JSON',
+  MCP_CORS_ORIGIN: 'MCP_CORS_ORIGIN',
+} as const;
+
+// Get version from package.json
+function getVersion(): string {
+  try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const packageJsonPath = join(__dirname, '..', 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version;
+  } catch (_error) {
+    // Fallback version if package.json can't be read
+    return '1.0.3';
+  }
+}
+
+export const version = getVersion();
+
+function getEnvVar(name: string, defaultValue?: string): string {
+  const value = process.env[name];
+  if (!value && !defaultValue) {
+    throw new Error(`Missing required environment variable: ${name}`);
+  }
+  return value || defaultValue || '';
+}
+
+export function getConfig(): ServerConfig {
+  return {
+    socialApiBaseUrl: getEnvVar(ENV_KEYS.SOCIALMEDIA_API_BASE_URL),
+    socialApiKey: getEnvVar(ENV_KEYS.SOCIALMEDIA_API_KEY),
+    teamName: getEnvVar(ENV_KEYS.SOCIALMEDIA_TEAM_ID),
+    port: Number.parseInt(getEnvVar(ENV_KEYS.PORT, '3000'), 10),
+    logLevel: getEnvVar(ENV_KEYS.LOG_LEVEL, 'info'),
+    apiTimeout: Number.parseInt(getEnvVar(ENV_KEYS.API_TIMEOUT, '30000'), 10), // 30 seconds default
+  };
+}
+
+export const config: ServerConfig = getConfig();
+
+export function validateConfig(): void {
+  const errors: string[] = [];
+
+  try {
+    const conf = getConfig();
+
+    if (!conf.socialApiBaseUrl) {
+      errors.push(`${ENV_KEYS.SOCIALMEDIA_API_BASE_URL} is required`);
+    }
+
+    if (!conf.socialApiKey) {
+      errors.push(`${ENV_KEYS.SOCIALMEDIA_API_KEY} is required`);
+    }
+
+    if (!conf.teamName) {
+      errors.push(`${ENV_KEYS.SOCIALMEDIA_TEAM_ID} is required`);
+    }
+
+    if (Number.isNaN(conf.port) || conf.port < 1 || conf.port > 65535) {
+      errors.push(`${ENV_KEYS.PORT} must be a valid port number (1-65535)`);
+    }
+  } catch (error) {
+    errors.push(error instanceof Error ? error.message : 'Unknown error');
+  }
+
+  if (errors.length > 0) {
+    throw new Error(`Configuration validation failed:\n${errors.join('\n')}`);
+  }
+}