{"_id":"@d0whc3r/egipci-mcp","_rev":"4-86107e286706809f7dd8d58cd437bfac","name":"@d0whc3r/egipci-mcp","dist-tags":{"latest":"1.2.1"},"versions":{"1.0.0":{"name":"@d0whc3r/egipci-mcp","version":"1.0.0","keywords":["mcp","egipci","gencat","arqueologia","archaeological","server"],"author":{"name":"d0whc3r"},"license":"MIT","_id":"@d0whc3r/egipci-mcp@1.0.0","maintainers":[{"name":"d0whc3r","email":"d0whc3r@gmail.com"}],"homepage":"https://github.com/d0whc3r/egipci-mcp#readme","bugs":{"url":"https://github.com/d0whc3r/egipci-mcp/issues"},"bin":{"egipci-mcp":"dist/index.js"},"dist":{"shasum":"164f818ef3141f76447b87c628eb716458a8f8de","tarball":"https://registry.npmjs.org/@d0whc3r/egipci-mcp/-/egipci-mcp-1.0.0.tgz","fileCount":3,"integrity":"sha512-HaOxBSDjqjn6FprIPOHM4F0JX5haXD9mZFXWrK8gjd6l01UH2gYVDb0tGTFuTZWagAiDX6ZTrRama5vZrugvgw==","signatures":[{"sig":"MEQCIBRVxJmNTciVoIX0jTUM2/3N/Wfi1CCTF1E2mp56nT7+AiAX698Uc4K25wsAsU8Gi9BeMMRUZWdq4sJf0Va7aaJTtQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14053},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"13fd5764ae178110d78c9bb351fec7c7ec294a8b","scripts":{"dev":"tsx --watch src/index.ts","lint":"oxlint src/","test":"vitest run","build":"tsup --env.prod","clean":"rm -rf dist dist-test node_modules/.cache coverage *.tsbuildinfo","start":"node dist/index.js","format":"prettier --write \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","fix-all":"npm run lint:fix && npm run format","prepare":"husky","test:ci":"vitest run --coverage --reporter=default --reporter=github-actions --reporter=junit --outputFile.junit=./test-results/junit.xml","ci:local":"pnpm run type-check && pnpm run lint && pnpm run format:check && pnpm run test:ci && pnpm run build","dev:full":"pnpm run clean:build && pnpm run type-check && pnpm run lint && pnpm run test:coverage && pnpm run build","lint:fix":"oxlint src/ --fix","pre-push":"npm run type-check && npm run lint && npm run test && npm run build","check-all":"npm run type-check && npm run lint && npm run format:check && npm run test && npm run build","clean:full":"rm -rf dist dist-test node_modules .pnpm-store coverage *.tsbuildinfo","deps:check":"pnpm outdated && pnpm audit","test:watch":"vitest","type-check":"tsc --build --verbose --noEmit","build:clean":"rm -rf dist && npm run build","clean:build":"rm -rf dist dist-test *.tsbuildinfo","deps:update":"pnpm update --latest","format:check":"prettier --check \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","test:coverage":"vitest run --coverage","security:audit":"pnpm audit --audit-level moderate","type-check:app":"tsc --noEmit --project tsconfig.app.json","type-check:test":"tsc --noEmit --project tsconfig.test.json","workspace:check":"pnpm -r exec -- echo 'Checking workspace package:'","security:outdated":"pnpm outdated","security:audit:fix":"pnpm audit --fix"},"_npmUser":{"name":"d0whc3r","email":"d0whc3r@gmail.com"},"repository":{"url":"git+https://github.com/d0whc3r/egipci-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"Servidor MCP para consultar información arqueológica desde el servicio EGIPCI de la Generalitat de Catalunya","directories":{},"lint-staged":{"src/**/*.{ts,js}":["oxlint --fix","prettier --write"],"src/**/*.{json,md}":["prettier --write"],"*.{json,md,yml,yaml}":["prettier --write"]},"_nodeVersion":"22.19.0","dependencies":{"got":"^14.4.9","zod":"^3","@modelcontextprotocol/sdk":"^1.19.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","tsup":"^8.5.0","husky":"^9.1.7","oxlint":"^1.19.0","vitest":"^3.2.4","prettier":"^3.6.2","typescript":"^5.9.3","@types/node":"^22","lint-staged":"^16.2.3","semantic-release":"^24.2.9","@vitest/coverage-v8":"^3.2.4","@semantic-release/git":"^10.0.1","@semantic-release/changelog":"^6.0.3","conventional-changelog-conventionalcommits":"^9.1.0"},"_npmOperationalInternal":{"tmp":"tmp/egipci-mcp_1.0.0_1759485625926_0.07173445765634368","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@d0whc3r/egipci-mcp","version":"1.1.0","keywords":["mcp","egipci","gencat","arqueologia","archaeological","server"],"author":{"name":"d0whc3r"},"license":"MIT","_id":"@d0whc3r/egipci-mcp@1.1.0","maintainers":[{"name":"d0whc3r","email":"d0whc3r@gmail.com"}],"homepage":"https://github.com/d0whc3r/egipci-mcp#readme","bugs":{"url":"https://github.com/d0whc3r/egipci-mcp/issues"},"bin":{"egipci-mcp":"dist/index.js"},"dist":{"shasum":"d24a1e475c4b6bf190a2080233bb2d3184272c92","tarball":"https://registry.npmjs.org/@d0whc3r/egipci-mcp/-/egipci-mcp-1.1.0.tgz","fileCount":4,"integrity":"sha512-RwIwd8n12M5mCV9XSjGZMp2RS+NJhgkcuVsNU/hGTbzU7Lxi6f4n5JZmF2ywLf7tynT9KDcg4XJYpIXO/X0/WA==","signatures":[{"sig":"MEUCIQCcuG7Vi1M4SZpVXU1ysUah7xemhmiKB0TXiIXB/nIaiAIgGjg9Z7SsV2nNeyXAPLof6Fy1OsDd7t3bnmVDxJBb/3w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15041},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"cc39eef89027595d07e6068b3a951460b83a9af1","scripts":{"dev":"tsx --watch src/index.ts","lint":"oxlint src/","test":"vitest run","build":"tsup --env.prod","clean":"rm -rf dist dist-test node_modules/.cache coverage *.tsbuildinfo","start":"node dist/index.js","format":"prettier --write \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","fix-all":"npm run lint:fix && npm run format","prepare":"husky","test:ci":"vitest run --coverage --reporter=default --reporter=github-actions --reporter=junit --outputFile.junit=./test-results/junit.xml","ci:local":"pnpm run type-check && pnpm run lint && pnpm run format:check && pnpm run test:ci && pnpm run build","dev:full":"pnpm run clean:build && pnpm run type-check && pnpm run lint && pnpm run test:coverage && pnpm run build","lint:fix":"oxlint src/ --fix","pre-push":"npm run type-check && npm run lint && npm run test && npm run build","check-all":"npm run type-check && npm run lint && npm run format:check && npm run test && npm run build","clean:full":"rm -rf dist dist-test node_modules .pnpm-store coverage *.tsbuildinfo","deps:check":"pnpm outdated && pnpm audit","test:watch":"vitest","type-check":"tsc --build --verbose --noEmit","build:clean":"rm -rf dist && npm run build","cache:clear":"pnpm store prune && rm -rf node_modules/.cache && rm -rf *.tsbuildinfo","clean:build":"rm -rf dist dist-test *.tsbuildinfo","deps:update":"pnpm update --latest","cache:verify":"pnpm store status","format:check":"prettier --check \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","cache:rebuild":"pnpm run cache:clear && pnpm install --frozen-lockfile","test:coverage":"vitest run --coverage","security:audit":"pnpm audit --audit-level moderate","type-check:app":"tsc --noEmit --project tsconfig.app.json","type-check:test":"tsc --noEmit --project tsconfig.test.json","workspace:check":"pnpm -r exec -- echo 'Checking workspace package:'","security:outdated":"pnpm outdated","security:audit:fix":"pnpm audit --fix"},"_npmUser":{"name":"d0whc3r","email":"d0whc3r@gmail.com"},"repository":{"url":"git+https://github.com/d0whc3r/egipci-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"Servidor MCP para consultar información arqueológica desde el servicio EGIPCI de la Generalitat de Catalunya","directories":{},"lint-staged":{"src/**/*.{ts,js}":["oxlint --fix","prettier --write"],"src/**/*.{json,md}":["prettier --write"],"*.{json,md,yml,yaml}":["prettier --write"]},"_nodeVersion":"22.19.0","dependencies":{"got":"^14.4.9","zod":"^3","@modelcontextprotocol/sdk":"^1.19.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","tsup":"^8.5.0","husky":"^9.1.7","oxlint":"^1.19.0","vitest":"^3.2.4","prettier":"^3.6.2","typescript":"^5.9.3","@types/node":"^22","lint-staged":"^16.2.3","semantic-release":"^24.2.9","@vitest/coverage-v8":"^3.2.4","@semantic-release/git":"^10.0.1","@semantic-release/changelog":"^6.0.3","conventional-changelog-conventionalcommits":"^9.1.0"},"_npmOperationalInternal":{"tmp":"tmp/egipci-mcp_1.1.0_1759486912601_0.5215990122504641","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@d0whc3r/egipci-mcp","version":"1.2.0","keywords":["mcp","egipci","gencat","archaeological","server","catalunya"],"author":{"name":"d0whc3r"},"license":"MIT","_id":"@d0whc3r/egipci-mcp@1.2.0","maintainers":[{"name":"d0whc3r","email":"d0whc3r@gmail.com"}],"homepage":"https://github.com/d0whc3r/egipci-mcp#readme","bugs":{"url":"https://github.com/d0whc3r/egipci-mcp/issues"},"bin":{"egipci-mcp":"dist/index.js"},"dist":{"shasum":"dc8889dac08e0364c0a27418b7fb247f5f990dc3","tarball":"https://registry.npmjs.org/@d0whc3r/egipci-mcp/-/egipci-mcp-1.2.0.tgz","fileCount":4,"integrity":"sha512-vwu9h3NyPgJ/mY+ETykYCLcSIwu9kFvVDGGfuzEUfKozicSkRa/Ag6E5ZVAyK0M141MYLTKFh25qlmeRiCQMLA==","signatures":[{"sig":"MEYCIQC4BZs64rahOKPELMXYEDEy1Mbh5QvhvtWtzfUyjmxv2QIhAPEitOLx6lrPjTJilekg/l+c+SzaOAUWhlE8aYk1GEXf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10773},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"8a8093bda1026aa35eb56bc9214a93efedc7f906","scripts":{"dev":"tsx --watch src/index.ts","lint":"oxlint src/","test":"vitest run","build":"tsup --env.prod","clean":"rm -rf dist coverage *.tsbuildinfo","start":"node dist/index.js","format":"prettier --write \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","prepare":"husky","test:ci":"vitest run --coverage --reporter=default --reporter=github-actions --reporter=junit --outputFile.junit=./test-results/junit.xml","lint:fix":"oxlint src/ --fix","test:watch":"vitest","type-check":"tsc --build --verbose --noEmit","format:check":"prettier --check \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","test:coverage":"vitest run --coverage","format:release":"prettier --write \"CHANGELOG.md\" \"package.json\""},"_npmUser":{"name":"d0whc3r","email":"d0whc3r@gmail.com"},"repository":{"url":"git+https://github.com/d0whc3r/egipci-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"MCP server for querying archaeological information from Catalunya's EGIPCI service","directories":{},"lint-staged":{"src/**/*.{ts,js}":["oxlint --fix","prettier --write"],"src/**/*.{json,md}":["prettier --write"],"*.{json,md,yml,yaml}":["prettier --write"]},"_nodeVersion":"22.19.0","dependencies":{"got":"^14.4.9","zod":"^3","@modelcontextprotocol/sdk":"^1.19.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","tsup":"^8.5.0","husky":"^9.1.7","oxlint":"^1.19.0","vitest":"^3.2.4","prettier":"^3.6.2","typescript":"^5.9.3","@types/node":"^22","lint-staged":"^16.2.3","semantic-release":"^24.2.9","@vitest/coverage-v8":"^3.2.4","@semantic-release/git":"^10.0.1","@semantic-release/exec":"^7.1.0","@semantic-release/changelog":"^6.0.3","conventional-changelog-conventionalcommits":"^9.1.0"},"_npmOperationalInternal":{"tmp":"tmp/egipci-mcp_1.2.0_1759489639252_0.07878369173221866","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@d0whc3r/egipci-mcp","version":"1.2.1","description":"MCP server for querying archaeological information from Catalunya's EGIPCI service","main":"dist/index.js","bin":{"egipci-mcp":"dist/index.js"},"type":"module","scripts":{"build":"tsup --env.prod","start":"node dist/index.js","dev":"tsx --watch src/index.ts","lint":"oxlint src/","lint:fix":"oxlint src/ --fix","format":"prettier --write \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","format:check":"prettier --check \"src/**/*.{ts,js,json,md}\" \"*.{json,md}\"","format:release":"prettier --write \"CHANGELOG.md\" \"package.json\"","type-check":"tsc --build --verbose --noEmit","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","test:ci":"vitest run --coverage --reporter=default --reporter=github-actions --reporter=junit --outputFile.junit=./test-results/junit.xml","clean":"rm -rf dist coverage *.tsbuildinfo","prepare":"husky"},"keywords":["mcp","egipci","gencat","archaeological","server","catalunya"],"author":{"name":"d0whc3r"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.19.1","got":"^14.4.9","zod":"^3"},"devDependencies":{"@semantic-release/changelog":"^6.0.3","@semantic-release/exec":"^7.1.0","@semantic-release/git":"^10.0.1","@types/node":"^22","@vitest/coverage-v8":"^3.2.4","conventional-changelog-conventionalcommits":"^9.1.0","husky":"^9.1.7","lint-staged":"^16.2.3","oxlint":"^1.19.0","prettier":"^3.6.2","semantic-release":"^24.2.9","tsup":"^8.5.0","tsx":"^4.20.6","typescript":"^5.9.3","vitest":"^3.2.4"},"engines":{"node":">=18.0.0"},"lint-staged":{"src/**/*.{ts,js}":["oxlint --fix","prettier --write"],"*.{json,md,yml,yaml}":["prettier --write"],"src/**/*.{json,md}":["prettier --write"]},"repository":{"type":"git","url":"git+https://github.com/d0whc3r/egipci-mcp.git"},"bugs":{"url":"https://github.com/d0whc3r/egipci-mcp/issues"},"homepage":"https://github.com/d0whc3r/egipci-mcp#readme","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_id":"@d0whc3r/egipci-mcp@1.2.1","gitHead":"6fba0315a1100adcd0855195b6c2d8ef344b72a1","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-uBPVyZLRYyc6GnVG8M1dISTfPKHWF2S00XMRL1TScLKmjhK8bOvnXW36+yGuxXaakpW0PTGUOwOMeJ1aSLqTIA==","shasum":"3b41f6a324ce32e55f2ef390d30d583cce624a73","tarball":"https://registry.npmjs.org/@d0whc3r/egipci-mcp/-/egipci-mcp-1.2.1.tgz","fileCount":4,"unpackedSize":10726,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCEg76LesNOA+HXLQgSoYpwB3EixOyxpwSLQrq2cSBLsAIhAKhZs3Mq6PLsg/dxLmEHGn/cnkWu3zlUXnrXrFblOHj4"}]},"_npmUser":{"name":"d0whc3r","email":"d0whc3r@gmail.com"},"directories":{},"maintainers":[{"name":"d0whc3r","email":"d0whc3r@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/egipci-mcp_1.2.1_1759497388232_0.9488068190708292"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-03T10:00:25.861Z","modified":"2025-10-03T13:16:28.922Z","1.0.0":"2025-10-03T10:00:26.120Z","1.1.0":"2025-10-03T10:21:52.803Z","1.2.0":"2025-10-03T11:07:19.436Z","1.2.1":"2025-10-03T13:16:28.438Z"},"bugs":{"url":"https://github.com/d0whc3r/egipci-mcp/issues"},"author":{"name":"d0whc3r"},"license":"MIT","homepage":"https://github.com/d0whc3r/egipci-mcp#readme","keywords":["mcp","egipci","gencat","archaeological","server","catalunya"],"repository":{"type":"git","url":"git+https://github.com/d0whc3r/egipci-mcp.git"},"description":"MCP server for querying archaeological information from Catalunya's EGIPCI service","maintainers":[{"name":"d0whc3r","email":"d0whc3r@gmail.com"}],"readme":"# EGIPCI MCP Server\n\nMCP (Model Context Protocol) server for querying archaeological site information from the EGIPCI service (Expedient d'Informació del Patrimoni Cultural Immoble) of the Department of Culture of the Generalitat de Catalunya.\n\nThis server allows AI editors like Claude Code, Cursor, and other MCP clients to access archaeological information from Catalunya through the standard MCP protocol.\n\n**Note**: This package is designed to be used as an MCP server through `npx`, not as a global installation.\n\n## Quick Start\n\nThis package is designed as an MCP server - no installation needed! Just configure it in your MCP client.\n\n## Usage\n\n### MCP Client Configuration\n\nTo use this server with an MCP client, add the following configuration to your `mcp.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"gencat-egipci\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@d0whc3r/egipci-mcp@latest\"],\n      \"env\": {\n        \"EGIPCI_COOKIE\": \"your_intranet_cookie_value_here\"\n      }\n    }\n  }\n}\n```\n\n### Available Tools\n\n#### `query_egipci_site`\n\nQuery information for a specific archaeological site.\n\n**Parameters:**\n\n- `cookie` (string, optional): `.intranet` cookie for EGIPCI authentication. If not provided, the `EGIPCI_COOKIE` environment variable will be used\n- `id` (string, required): Archaeological site ID to query\n\n**Usage example:**\n\nWith cookie as parameter:\n\n```json\n{\n  \"name\": \"query_egipci_site\",\n  \"arguments\": {\n    \"cookie\": \"your_intranet_cookie_value\",\n    \"id\": \"12345\"\n  }\n}\n```\n\nWith cookie from environment variable:\n\n```json\n{\n  \"name\": \"query_egipci_site\",\n  \"arguments\": {\n    \"id\": \"12345\"\n  }\n}\n```\n\n**Response:**\nReturns the site information in XML format as provided by the EGIPCI service.\n\n### Authentication Methods\n\n#### Using Environment Variable (Recommended)\n\nThe safest and most convenient way is to configure the cookie in the `EGIPCI_COOKIE` environment variable in the MCP configuration. This has several advantages:\n\n- **Security**: The cookie is not exposed in each tool call\n- **Convenience**: You don't need to pass the cookie in each query\n- **Reusability**: Single configuration for all queries\n- **Maintenance**: Easy update when the cookie expires\n\n#### Using Cookie Parameter\n\nYou can also pass the cookie directly as a parameter in each call. This is useful for:\n\n- Using different cookies for different queries\n- Cases where you cannot configure environment variables\n- Testing and development\n\n### Obtaining Authentication Cookie\n\nTo obtain the required `.intranet` cookie:\n\n1. Go to https://egipci.cultura.gencat.cat/ in your browser\n2. Log in with your credentials\n3. Open developer tools (F12)\n4. Go to the \"Application\" or \"Storage\" tab\n5. In \"Cookies\", look for the `.intranet` cookie\n6. Copy the cookie value to use as parameter\n\n### Error Handling\n\nThe server handles various types of errors using the `got` library:\n\n- **Missing or invalid parameters**: Input validation with Zod\n- **HTTP errors**: Status codes 4xx/5xx using `got.HTTPError`\n- **Network errors**: Connectivity issues using `got.RequestError`\n- **Authentication errors**: Invalid or expired cookie\n- **Format errors**: XML response validation\n\nAll errors are returned with descriptive messages.\n\n## Development\n\nFor contributors and developers working on this project:\n\n- **Development Setup**: See [`.kiro/steering/tech.md`](.kiro/steering/tech.md) for technology stack and commands\n- **Testing Guidelines**: See [`.kiro/steering/testing.md`](.kiro/steering/testing.md) for testing patterns and requirements\n- **CI/CD Pipeline**: See [`.kiro/steering/pipeline.md`](.kiro/steering/pipeline.md) for deployment and quality gates\n- **Project Structure**: See [`.kiro/steering/structure.md`](.kiro/steering/structure.md) for architecture details\n\n## Requirements\n\n- Valid `.intranet` cookie for EGIPCI authentication\n- For development: Node.js >= 18.0.0, pnpm\n","readmeFilename":"README.md"}