{"_id":"@atom8n/mcp-notify","_rev":"2-e7b2e903547b03b5d30e9892746d22e4","name":"@atom8n/mcp-notify","dist-tags":{"latest":"0.5.3"},"versions":{"0.5.3":{"name":"@atom8n/mcp-notify","version":"0.5.3","license":"MIT","_id":"@atom8n/mcp-notify@0.5.3","maintainers":[{"name":"atom8n","email":"atom8n@gmail.com"}],"bin":{"mcp-notify":"lib/index.mjs"},"dist":{"shasum":"c6cfd41aff106e22e2b21eb3a3f37f633c1b09b8","tarball":"https://registry.npmjs.org/@atom8n/mcp-notify/-/mcp-notify-0.5.3.tgz","fileCount":31,"integrity":"sha512-tvVt8Q/9savIIZB4aCeEHpHpkW8VDTK1rgRafHg5LuDnUfUHxySQlUVWJJVJ40JvuYIa3BgoDmbPh4LoWwXlWg==","signatures":[{"sig":"MEUCICVlK/epMAnSssh/hHLT6/UPEkZTrQKLP9wSMfQl3xegAiEA3mRzvJ0WNN9YI8W1tJGxWl20hKReRXn4blPrV/bxklo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121035},"main":"index.js","gitHead":"3da161c526171f76539b4e18573cad3da4fad05e","scripts":{"build":"tsc","start":"node ./lib/index.mjs","prepare":"tsc && shx chmod +x ./lib/index.mjs"},"_npmUser":{"name":"atom8n","email":"atom8n@gmail.com"},"_npmVersion":"10.9.2","description":"A MCP server for system notifications (Windows/macOS)","directories":{},"_nodeVersion":"22.17.1","dependencies":{"rimraf":"^6.0.1","spawn-rx":"^4.0.0","node-notifier":"^10.0.1","@modelcontextprotocol/sdk":"^1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","ts-node":"^10.9.2","typescript":"^5.6.3","@types/node":"^20.0.0","@types/node-notifier":"^5.4.10"},"_npmOperationalInternal":{"tmp":"tmp/mcp-notify_0.5.3_1760807067177_0.5638211443837666","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-10-18T17:04:27.119Z","modified":"2026-01-12T18:06:44.107Z","0.5.3":"2025-10-18T17:04:27.378Z"},"license":"MIT","description":"A MCP server for system notifications (Windows/macOS)","maintainers":[{"email":"atom8n@gmail.com","name":"atom8n-user"}],"readme":"# @atom8n/mcp-logger\r\n\r\nA Model Context Protocol (MCP) server that fetches logs from a local server running on `localhost:6277`. This package provides a simple interface to retrieve paginated log entries through the MCP protocol.\r\n\r\n## Overview\r\n\r\nThe `mcp-logger` is an MCP server implementation that acts as a bridge between MCP clients and a local logging service. It provides a single tool called `get_logs` that fetches log entries from `http://localhost:6277/logs/current` with support for pagination.\r\n\r\n## Features\r\n\r\n- **Log Retrieval**: Fetch logs from a local server endpoint\r\n- **Pagination Support**: Retrieve logs in pages with configurable limits\r\n- **Error Handling**: Comprehensive error handling with descriptive messages\r\n- **MCP Protocol**: Full compliance with Model Context Protocol standards\r\n- **TypeScript Support**: Built with TypeScript for type safety\r\n\r\n## Installation\r\n\r\n### Global Installation\r\n```bash\r\nnpm install -g @atom8n/mcp-logger\r\n```\r\n\r\n### Local Installation\r\n```bash\r\nnpm install @atom8n/mcp-logger\r\n```\r\n\r\n## MCP Configuration\r\n\r\nTo use this MCP server with an MCP client, add the following configuration to your MCP client settings:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mcp-logger\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"@atom8n/mcp-logger\"\r\n      ]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Alternative Configuration (if installed globally)\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"mcp-logger\": {\r\n      \"command\": \"mcp-logger\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Usage\r\n\r\nOnce configured, the MCP server provides the following tool:\r\n\r\n### `get_logs`\r\n\r\nFetches logs from the local server at `http://localhost:6277/logs/current`.\r\n\r\n**Parameters:**\r\n- `page` (optional, number): Page number for pagination (default: 1)\r\n- `limit` (optional, number): Number of log entries per page (default: 50)\r\n\r\n**Example Usage:**\r\n```javascript\r\n// Fetch first page with default limit (50 entries)\r\nawait mcpClient.callTool(\"get_logs\", {});\r\n\r\n// Fetch second page with 25 entries per page\r\nawait mcpClient.callTool(\"get_logs\", {\r\n  page: 2,\r\n  limit: 25\r\n});\r\n```\r\n\r\n## Prerequisites\r\n\r\n- **Local Server**: A server must be running on `localhost:6277` that provides logs at the `/logs/current` endpoint\r\n- **Node.js**: Version 14 or higher\r\n- **MCP Client**: A compatible MCP client to interact with the server\r\n\r\n## Error Handling\r\n\r\nThe server provides detailed error messages for common scenarios:\r\n\r\n- **Connection Refused**: When the local server is not running\r\n- **HTTP Errors**: When the server responds with error status codes\r\n- **Timeout Errors**: When requests take longer than 10 seconds\r\n- **Network Issues**: When no response is received\r\n\r\n## Development\r\n\r\n### Project Structure\r\n\r\n```\r\nmcp-installer/\r\n├── src/\r\n│   └── index.mts          # Main TypeScript source\r\n├── lib/\r\n│   ├── index.mjs          # Compiled JavaScript\r\n│   ├── index.mjs.map      # Source map\r\n│   └── index.d.mts        # TypeScript declarations\r\n├── package.json           # Package configuration\r\n├── tsconfig.json          # TypeScript configuration\r\n└── eslint.config.mjs      # ESLint configuration\r\n```\r\n\r\n### Building from Source\r\n\r\n1. Clone the repository:\r\n```bash\r\ngit clone <repository-url>\r\ncd mcp-installer\r\n```\r\n\r\n2. Install dependencies:\r\n```bash\r\nnpm install\r\n```\r\n\r\n3. Build the project:\r\n```bash\r\nnpm run prepare\r\n```\r\n\r\n### Dependencies\r\n\r\n**Runtime Dependencies:**\r\n- `@modelcontextprotocol/sdk`: MCP SDK for server implementation\r\n- `axios`: HTTP client for making requests\r\n- `rimraf`: Cross-platform file deletion utility\r\n- `spawn-rx`: Observable-based process spawning\r\n\r\n**Development Dependencies:**\r\n- `@types/node`: TypeScript definitions for Node.js\r\n- `shx`: Cross-platform shell commands\r\n- `ts-node`: TypeScript execution for Node.js\r\n- `typescript`: TypeScript compiler\r\n\r\n## API Reference\r\n\r\n### Server Configuration\r\n\r\nThe MCP server is configured with:\r\n- **Name**: `mcp-logger`\r\n- **Version**: `0.5.3`\r\n- **Transport**: StdioServerTransport\r\n- **Capabilities**: Tools support\r\n\r\n### Tool Schema\r\n\r\n```typescript\r\n{\r\n  name: \"get_logs\",\r\n  description: \"Fetch logs from the local server at http://localhost:6277/logs/current\",\r\n  inputSchema: {\r\n    type: \"object\",\r\n    properties: {\r\n      page: {\r\n        type: \"number\",\r\n        description: \"Page number for pagination (default: 1)\",\r\n        default: 1\r\n      },\r\n      limit: {\r\n        type: \"number\",\r\n        description: \"Number of log entries per page (default: 50)\",\r\n        default: 50\r\n      }\r\n    },\r\n    required: []\r\n  }\r\n}\r\n```\r\n\r\n## License\r\n\r\nMIT License - see [COPYING](COPYING) file for details.\r\n\r\n## Contributing\r\n\r\nPlease read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.\r\n\r\n## Version History\r\n\r\n- **0.5.3**: Current version with MCP SDK v1.0.1 support\r\n- **0.5.2**: Previous version (as referenced in source code)\r\n\r\n## Support\r\n\r\nFor issues and questions:\r\n- Check if the local server is running on `localhost:6277`\r\n- Verify the `/logs/current` endpoint is accessible\r\n- Review error messages for specific connection issues\r\n\r\n## Changelog\r\n\r\n### v0.5.3\r\n- Updated to MCP SDK v1.0.1\r\n- Improved error handling\r\n- Enhanced TypeScript support\r\n- Updated dependencies\r\n","readmeFilename":"README.md"}