{"_id":"@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1","_rev":"3-38a38130c2553fc471a750a8950847f6","name":"@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1","version":"1.0.0","keywords":["mcp","model-context-protocol","ai","server","linear","claude","ai-tools","api-integration"],"author":{"name":"Coretext AI","email":"npm@coretext.ai"},"license":"MIT","_id":"@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1@1.0.0","maintainers":[{"name":"rugved-core","email":"rugved@coretextai.dev"},{"name":"ctxmitch","email":"mitchell@coretextai.dev"},{"name":"gerson-coretext","email":"gerson@coretextai.dev"}],"homepage":"https://github.com/coretext-ai/first-mcp-server#readme","bugs":{"url":"https://github.com/coretext-ai/first-mcp-server/issues"},"bin":{"first-mcp-server":"dist/index.js"},"dist":{"shasum":"75cbe207ddaa26a1a5c990ddb9b97bac719ef71b","tarball":"https://registry.npmjs.org/@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1/-/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1-1.0.0.tgz","fileCount":30,"integrity":"sha512-TpmVG2Etlg2ou7EGpwltuLQp0vyBsYeeZ2B+WRqE0g3911SydX4vx+YRRZAmX2zWzGjKefZvfPXuWadVRfJcIg==","signatures":[{"sig":"MEUCIQC4T33MC69O9CYUWXcjd5fVelBZRMPenXCdwuQngcMtrgIgPl5v8IXmxdHh387Zju1lSXUB8Uln3dRUVaaixFFMZvU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":230618},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"npm":">=8.0.0","node":">=18.0.0"},"scripts":{"dev":"tsx src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","watch":"tsx --watch src/index.ts"},"_npmUser":{"name":"ctxmitch","email":"mitchell@coretextai.dev"},"repository":{"url":"git+https://github.com/coretext-ai/first-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"Just testing the console.","directories":{},"_nodeVersion":"18.20.8","dependencies":{"axios":"^1.6.0","dotenv":"^16.3.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","jest":"^29.5.0","eslint":"^8.42.0","typescript":"^5.0.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1_1.0.0_1753217682942_0.9558056135063282","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1","version":"1.0.1","description":"Just testing the console.","type":"module","main":"dist/index.js","bin":{"first-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","watch":"tsx --watch src/index.ts","test":"jest","lint":"eslint src/**/*.ts"},"keywords":["mcp","model-context-protocol","ai","server","linear","claude","ai-tools","api-integration"],"author":{"name":"Coretext AI","email":"npm@coretext.ai"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","axios":"^1.6.0","dotenv":"^16.3.0"},"devDependencies":{"@types/node":"^20.0.0","@typescript-eslint/eslint-plugin":"^7.0.0","@typescript-eslint/parser":"^7.0.0","eslint":"^8.42.0","jest":"^29.5.0","tsx":"^4.0.0","typescript":"^5.0.0"},"repository":{"type":"git","url":"git+https://github.com/coretext-ai/first-mcp-server.git"},"types":"dist/index.d.ts","engines":{"node":">=18.0.0","npm":">=8.0.0"},"_id":"@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1@1.0.1","bugs":{"url":"https://github.com/coretext-ai/first-mcp-server/issues"},"homepage":"https://github.com/coretext-ai/first-mcp-server#readme","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-hXo5EaqU3uBHlZuUI8aLxaOWBm7oB7cRkmaT9ku+LXynpx+HUSUHhl0UsG7+fIIgLaJCPa4EHRN6mRJDrZx9PQ==","shasum":"ced7e7633820d0cba6d187e31339ee8933f6be70","tarball":"https://registry.npmjs.org/@coretext-ai/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1/-/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1-1.0.1.tgz","fileCount":30,"unpackedSize":230618,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDI1w982B63fUSYOpZjYqq3UlpUxZBwxBOmBuwLdwREEAiBKvDOFm0B6+1mP4pVKHv6w3HvVtUdEjg1rKPO6wMeWew=="}]},"_npmUser":{"name":"ctxmitch","email":"mitchell@coretextai.dev"},"directories":{},"maintainers":[{"name":"rugved-core","email":"rugved@coretextai.dev"},{"name":"ctxmitch","email":"mitchell@coretextai.dev"},{"name":"gerson-coretext","email":"gerson@coretextai.dev"},{"name":"dgomezcortextai","email":"daniel@coretextai.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/coretext-rugved-aa8877fa-9785-48b5-8415-446d229c5cb1_1.0.1_1753378216734_0.9638811987819984"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-22T20:54:42.797Z","modified":"2025-07-24T17:30:17.265Z","1.0.0":"2025-07-22T20:54:43.140Z","1.0.1":"2025-07-24T17:30:16.961Z"},"bugs":{"url":"https://github.com/coretext-ai/first-mcp-server/issues"},"author":{"name":"Coretext AI","email":"npm@coretext.ai"},"license":"MIT","homepage":"https://github.com/coretext-ai/first-mcp-server#readme","keywords":["mcp","model-context-protocol","ai","server","linear","claude","ai-tools","api-integration"],"repository":{"type":"git","url":"git+https://github.com/coretext-ai/first-mcp-server.git"},"description":"Just testing the console.","maintainers":[{"name":"rugved-core","email":"rugved@coretextai.dev"},{"name":"ctxmitch","email":"mitchell@coretextai.dev"},{"name":"gerson-coretext","email":"gerson@coretextai.dev"},{"name":"dgomezcortextai","email":"daniel@coretextai.dev"}],"readme":"# first-mcp-server\n\nJust testing the console.\n\nThis MCP server was generated using the Template Orchestrator and includes the following integrations:\n\n## Linear Integration\n\n**Endpoints included:** 20\n- `linear_get_user`: Get user details and profile information\n- `linear_get_issue`: Retrieve issue details by ID or identifier\n- `linear_get_viewer`: Get current user information (viewer)\n- `linear_list_users`: List all users in the workspace\n- `linear_get_project`: Get project details including associated issues\n- `linear_list_issues`: List issues with optional filtering by team, state, assignee, and labels\n- `linear_list_labels`: List all labels available in the workspace\n- `linear_apply_labels`: Apply labels to an issue\n- `linear_assign_issue`: Assign a user to an issue\n- `linear_create_issue`: Create a new issue with title, description, and team assignment\n- `linear_create_label`: Create a new label for issue categorization\n- `linear_delete_issue`: Delete an issue by ID\n- `linear_update_issue`: Update issue properties including title, description, priority, and state\n- `linear_list_comments`: List comments for an issue\n- `linear_list_projects`: List all projects with optional filtering\n- `linear_search_issues`: Search issues using text query and filters\n- `linear_create_comment`: Create a comment on an issue\n- `linear_create_project`: Create a new project\n- `linear_update_project`: Update project properties\n- `linear_transition_issue`: Transition an issue to a different workflow state\n\n**Required environment variables:**\n- `LINEAR_API_KEY`\n\n\n## Installation\n\n```bash\nnpm install @coretext-ai/first-mcp-server\n```\n\n## Environment Setup\n\nCreate a `.env` file with the following variables:\n\n```env\nLINEAR_API_KEY=your_linear_api_key_here\n\n# Centralized Log Shipping Configuration\nLOG_SHIPPING_ENABLED=true\nLOG_INGESTION_URL=https://your-log-endpoint.execute-api.region.amazonaws.com/dev/logs\nLOG_INGESTION_API_KEY=your_api_key_here\nCORETEXT_USER=your_user_id_here\nLOG_LEVEL=ERROR\nLOG_SHIPPING_BATCH_SIZE=500\nLOG_SHIPPING_INTERVAL=5000\nLOG_SHIPPING_MAX_RETRIES=3\n```\n\n## Usage\n\n### Running the server\n\n```bash\n# Development mode\nnpm run dev\n\n# Production mode\nnpm run build && npm start\n```\n\n### Using with Claude Desktop\n\nAdd this to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"first-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coretext-ai/first-mcp-server\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\nThis server provides 20 tools across 1 integrations:\n\n### Linear Tools\n- **linear_get_user**: Get user details and profile information\n- **linear_get_issue**: Retrieve issue details by ID or identifier\n- **linear_get_viewer**: Get current user information (viewer)\n- **linear_list_users**: List all users in the workspace\n- **linear_get_project**: Get project details including associated issues\n- **linear_list_issues**: List issues with optional filtering by team, state, assignee, and labels\n- **linear_list_labels**: List all labels available in the workspace\n- **linear_apply_labels**: Apply labels to an issue\n- **linear_assign_issue**: Assign a user to an issue\n- **linear_create_issue**: Create a new issue with title, description, and team assignment\n- **linear_create_label**: Create a new label for issue categorization\n- **linear_delete_issue**: Delete an issue by ID\n- **linear_update_issue**: Update issue properties including title, description, priority, and state\n- **linear_list_comments**: List comments for an issue\n- **linear_list_projects**: List all projects with optional filtering\n- **linear_search_issues**: Search issues using text query and filters\n- **linear_create_comment**: Create a comment on an issue\n- **linear_create_project**: Create a new project\n- **linear_update_project**: Update project properties\n- **linear_transition_issue**: Transition an issue to a different workflow state\n\n\n## Centralized Log Shipping\n\nThis MCP server includes built-in centralized log shipping functionality that sends structured logs to a centralized endpoint for monitoring, debugging, and analytics.\n\n### Features\n\n- **Batch Processing**: Logs are batched (up to 500 logs per request) and sent every 5 seconds\n- **Retry Logic**: Automatic retry with exponential backoff for failed requests\n- **Structured Logging**: All logs include timestamps, user context, session IDs, and metadata\n- **Configurable Log Levels**: DEBUG, INFO, WARN, ERROR, FATAL\n- **Non-blocking**: Log shipping runs asynchronously to prevent MCP performance impact\n- **Graceful Degradation**: Server continues to function even if log shipping fails\n\n### Configuration\n\nEnable log shipping by setting these environment variables:\n\n```env\n# Required for log shipping\nLOG_SHIPPING_ENABLED=true\nLOG_INGESTION_URL=https://abc123.execute-api.us-east-1.amazonaws.com/dev/logs\nLOG_INGESTION_API_KEY=sk_abc123def456ghi789...\nCORETEXT_USER=user_12345\n\n# Optional configuration\nLOG_LEVEL=ERROR                    # DEBUG, INFO, WARN, ERROR, FATAL\nLOG_SHIPPING_BATCH_SIZE=500        # 1-1000 logs per batch\nLOG_SHIPPING_INTERVAL=5000         # Flush interval in milliseconds\nLOG_SHIPPING_MAX_RETRIES=3         # Max retry attempts\n```\n\n### Log Format\n\nLogs are sent in the following JSON format:\n\n```json\n{\n  \"logs\": [\n    {\n      \"timestamp\": \"2024-01-15T10:30:00.000Z\",\n      \"level\": \"INFO\",\n      \"message\": \"User action completed successfully\",\n      \"user_id\": \"user_12345\",\n      \"session_id\": \"session_67890\",\n      \"metadata\": {\n        \"action\": \"file_upload\",\n        \"file_size\": 1024,\n        \"duration_ms\": 450\n      }\n    }\n  ]\n}\n```\n\n### API Endpoint Requirements\n\nThe log ingestion endpoint must:\n- Accept POST requests to `/logs`\n- Require `x-api-key` header for authentication\n- Accept JSON payloads with `logs` array\n- Return appropriate HTTP status codes (200, 400, 401, 429, 500)\n\n### Monitoring\n\nThe server tracks log shipping health and provides status information including:\n- Last successful flush timestamp\n- Current queue size\n- Configuration status\n- Error tracking and retry counts\n\n### Troubleshooting\n\nCommon issues and solutions:\n\n1. **Logs not appearing**: Check `LOG_SHIPPING_ENABLED=true` and API credentials\n2. **401 Authentication errors**: Verify `LOG_INGESTION_API_KEY` is correct\n3. **429 Rate limiting**: Increase `LOG_SHIPPING_INTERVAL` or reduce `LOG_SHIPPING_BATCH_SIZE`\n4. **SSL/TLS errors**: Ensure `LOG_INGESTION_URL` uses HTTPS protocol\n\n### Privacy and Security\n\n- Log shipping is disabled by default\n- No sensitive data (API keys, tokens) is included in log content\n- All communication uses HTTPS with API key authentication\n- User identification is limited to the `CORETEXT_USER` environment variable\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build\nnpm run build\n\n# Run tests\nnpm run test\n\n# Lint\nnpm run lint\n```\n\n## Generated Information\n\n- **Generated at**: Thu Jul 24 2025 17:28:39 GMT+0000 (Coordinated Universal Time)\n- **Orchestrator version**: 1.0.0\n- **Template repository**: Coretext-AI-Dev/server-template-v2\n- **Total endpoints**: 20\n\n## License\n\nMIT","readmeFilename":"README.md"}