@cyanheads/sanctions-screening-mcp-server 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (110) hide show
  1. package/AGENTS.md +452 -0
  2. package/CLAUDE.md +452 -0
  3. package/Dockerfile +126 -0
  4. package/LICENSE +201 -0
  5. package/README.md +354 -0
  6. package/changelog/0.1.x/0.1.0.md +26 -0
  7. package/changelog/template.md +127 -0
  8. package/dist/config/server-config.d.ts +37 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +87 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +11 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +70 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/prompts/definitions/index.d.ts +12 -0
  17. package/dist/mcp-server/prompts/definitions/index.d.ts.map +1 -0
  18. package/dist/mcp-server/prompts/definitions/index.js +9 -0
  19. package/dist/mcp-server/prompts/definitions/index.js.map +1 -0
  20. package/dist/mcp-server/prompts/definitions/vet-counterparty.prompt.d.ts +14 -0
  21. package/dist/mcp-server/prompts/definitions/vet-counterparty.prompt.d.ts.map +1 -0
  22. package/dist/mcp-server/prompts/definitions/vet-counterparty.prompt.js +42 -0
  23. package/dist/mcp-server/prompts/definitions/vet-counterparty.prompt.js.map +1 -0
  24. package/dist/mcp-server/resources/definitions/designation.resource.d.ts +25 -0
  25. package/dist/mcp-server/resources/definitions/designation.resource.d.ts.map +1 -0
  26. package/dist/mcp-server/resources/definitions/designation.resource.js +57 -0
  27. package/dist/mcp-server/resources/definitions/designation.resource.js.map +1 -0
  28. package/dist/mcp-server/resources/definitions/entity.resource.d.ts +17 -0
  29. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -0
  30. package/dist/mcp-server/resources/definitions/entity.resource.js +40 -0
  31. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -0
  32. package/dist/mcp-server/resources/definitions/index.d.ts +32 -0
  33. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  34. package/dist/mcp-server/resources/definitions/index.js +11 -0
  35. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  36. package/dist/mcp-server/resources/definitions/sources.resource.d.ts +9 -0
  37. package/dist/mcp-server/resources/definitions/sources.resource.d.ts.map +1 -0
  38. package/dist/mcp-server/resources/definitions/sources.resource.js +50 -0
  39. package/dist/mcp-server/resources/definitions/sources.resource.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/_shared.d.ts +13 -0
  41. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/_shared.js +13 -0
  43. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/get-designation.tool.d.ts +78 -0
  45. package/dist/mcp-server/tools/definitions/get-designation.tool.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/get-designation.tool.js +168 -0
  47. package/dist/mcp-server/tools/definitions/get-designation.tool.js.map +1 -0
  48. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +55 -0
  49. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  50. package/dist/mcp-server/tools/definitions/get-entity.tool.js +176 -0
  51. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  52. package/dist/mcp-server/tools/definitions/index.d.ts +306 -0
  53. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  54. package/dist/mcp-server/tools/definitions/index.js +21 -0
  55. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  56. package/dist/mcp-server/tools/definitions/list-sources.tool.d.ts +23 -0
  57. package/dist/mcp-server/tools/definitions/list-sources.tool.d.ts.map +1 -0
  58. package/dist/mcp-server/tools/definitions/list-sources.tool.js +106 -0
  59. package/dist/mcp-server/tools/definitions/list-sources.tool.js.map +1 -0
  60. package/dist/mcp-server/tools/definitions/resolve-entity.tool.d.ts +51 -0
  61. package/dist/mcp-server/tools/definitions/resolve-entity.tool.d.ts.map +1 -0
  62. package/dist/mcp-server/tools/definitions/resolve-entity.tool.js +148 -0
  63. package/dist/mcp-server/tools/definitions/resolve-entity.tool.js.map +1 -0
  64. package/dist/mcp-server/tools/definitions/screen-name.tool.d.ts +82 -0
  65. package/dist/mcp-server/tools/definitions/screen-name.tool.d.ts.map +1 -0
  66. package/dist/mcp-server/tools/definitions/screen-name.tool.js +172 -0
  67. package/dist/mcp-server/tools/definitions/screen-name.tool.js.map +1 -0
  68. package/dist/mcp-server/tools/definitions/trace-ownership.tool.d.ts +74 -0
  69. package/dist/mcp-server/tools/definitions/trace-ownership.tool.d.ts.map +1 -0
  70. package/dist/mcp-server/tools/definitions/trace-ownership.tool.js +273 -0
  71. package/dist/mcp-server/tools/definitions/trace-ownership.tool.js.map +1 -0
  72. package/dist/services/screening/fixtures.d.ts +17 -0
  73. package/dist/services/screening/fixtures.d.ts.map +1 -0
  74. package/dist/services/screening/fixtures.js +162 -0
  75. package/dist/services/screening/fixtures.js.map +1 -0
  76. package/dist/services/screening/gleif-ingest.d.ts +68 -0
  77. package/dist/services/screening/gleif-ingest.d.ts.map +1 -0
  78. package/dist/services/screening/gleif-ingest.js +251 -0
  79. package/dist/services/screening/gleif-ingest.js.map +1 -0
  80. package/dist/services/screening/sanctions-ingest.d.ts +46 -0
  81. package/dist/services/screening/sanctions-ingest.d.ts.map +1 -0
  82. package/dist/services/screening/sanctions-ingest.js +688 -0
  83. package/dist/services/screening/sanctions-ingest.js.map +1 -0
  84. package/dist/services/screening/schema.d.ts +52 -0
  85. package/dist/services/screening/schema.d.ts.map +1 -0
  86. package/dist/services/screening/schema.js +125 -0
  87. package/dist/services/screening/schema.js.map +1 -0
  88. package/dist/services/screening/screening-service.d.ts +203 -0
  89. package/dist/services/screening/screening-service.d.ts.map +1 -0
  90. package/dist/services/screening/screening-service.js +702 -0
  91. package/dist/services/screening/screening-service.js.map +1 -0
  92. package/dist/services/screening/text-matching.d.ts +53 -0
  93. package/dist/services/screening/text-matching.d.ts.map +1 -0
  94. package/dist/services/screening/text-matching.js +514 -0
  95. package/dist/services/screening/text-matching.js.map +1 -0
  96. package/dist/services/screening/types.d.ts +154 -0
  97. package/dist/services/screening/types.d.ts.map +1 -0
  98. package/dist/services/screening/types.js +24 -0
  99. package/dist/services/screening/types.js.map +1 -0
  100. package/dist/services/screening/xml.d.ts +29 -0
  101. package/dist/services/screening/xml.d.ts.map +1 -0
  102. package/dist/services/screening/xml.js +46 -0
  103. package/dist/services/screening/xml.js.map +1 -0
  104. package/package.json +119 -0
  105. package/scripts/_mirror-context.ts +21 -0
  106. package/scripts/mirror-init.ts +66 -0
  107. package/scripts/mirror-refresh.ts +56 -0
  108. package/scripts/mirror-seed.ts +36 -0
  109. package/scripts/mirror-verify.ts +44 -0
  110. package/server.json +148 -0
package/server.json ADDED
@@ -0,0 +1,148 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/sanctions-screening-mcp-server",
4
+ "description": "Screen names against OFAC, EU, UK, UN sanctions lists; resolve entities via GLEIF. Screening aid.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/sanctions-screening-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.1.0",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "registryBaseUrl": "https://registry.npmjs.org",
14
+ "identifier": "@cyanheads/sanctions-screening-mcp-server",
15
+ "runtimeHint": "node",
16
+ "version": "0.1.0",
17
+ "packageArguments": [
18
+ {
19
+ "type": "positional",
20
+ "value": "run"
21
+ },
22
+ {
23
+ "type": "positional",
24
+ "value": "start:stdio"
25
+ }
26
+ ],
27
+ "environmentVariables": [
28
+ {
29
+ "name": "MCP_LOG_LEVEL",
30
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
31
+ "format": "string",
32
+ "isRequired": false,
33
+ "default": "info"
34
+ },
35
+ {
36
+ "name": "SANCTIONS_MIRROR_PATH",
37
+ "description": "Filesystem path for the local SQLite mirror. All sources are keyless; no API key is required. Populate the mirror out-of-band with `bun run mirror:init`.",
38
+ "format": "string",
39
+ "isRequired": false,
40
+ "default": "./data/sanctions.db"
41
+ },
42
+ {
43
+ "name": "SANCTIONS_FUZZY_MIN_SCORE",
44
+ "description": "Default Jaro-Winkler similarity floor (0-1) for fuzzy matches when the caller omits min_score.",
45
+ "format": "string",
46
+ "isRequired": false,
47
+ "default": "0.85"
48
+ },
49
+ {
50
+ "name": "SANCTIONS_FUZZY_MAX_RESULTS",
51
+ "description": "Hard cap on fuzzy candidates scored per query, to bound work on short queries.",
52
+ "format": "string",
53
+ "isRequired": false,
54
+ "default": "50"
55
+ }
56
+ ],
57
+ "transport": {
58
+ "type": "stdio"
59
+ }
60
+ },
61
+ {
62
+ "registryType": "npm",
63
+ "registryBaseUrl": "https://registry.npmjs.org",
64
+ "identifier": "@cyanheads/sanctions-screening-mcp-server",
65
+ "runtimeHint": "node",
66
+ "version": "0.1.0",
67
+ "packageArguments": [
68
+ {
69
+ "type": "positional",
70
+ "value": "run"
71
+ },
72
+ {
73
+ "type": "positional",
74
+ "value": "start:http"
75
+ }
76
+ ],
77
+ "environmentVariables": [
78
+ {
79
+ "name": "MCP_HTTP_HOST",
80
+ "description": "The hostname for the HTTP server.",
81
+ "format": "string",
82
+ "isRequired": false,
83
+ "default": "127.0.0.1"
84
+ },
85
+ {
86
+ "name": "MCP_HTTP_PORT",
87
+ "description": "The port to run the HTTP server on.",
88
+ "format": "string",
89
+ "isRequired": false,
90
+ "default": "3010"
91
+ },
92
+ {
93
+ "name": "MCP_HTTP_ENDPOINT_PATH",
94
+ "description": "The endpoint path for the MCP server.",
95
+ "format": "string",
96
+ "isRequired": false,
97
+ "default": "/mcp"
98
+ },
99
+ {
100
+ "name": "MCP_AUTH_MODE",
101
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
102
+ "format": "string",
103
+ "isRequired": false,
104
+ "default": "none"
105
+ },
106
+ {
107
+ "name": "MCP_LOG_LEVEL",
108
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
109
+ "format": "string",
110
+ "isRequired": false,
111
+ "default": "info"
112
+ },
113
+ {
114
+ "name": "SANCTIONS_MIRROR_PATH",
115
+ "description": "Filesystem path for the local SQLite mirror; a persistent volume on a hosted deployment. All sources are keyless; no API key is required.",
116
+ "format": "string",
117
+ "isRequired": false,
118
+ "default": "./data/sanctions.db"
119
+ },
120
+ {
121
+ "name": "SANCTIONS_REFRESH_CRON",
122
+ "description": "Cron for the scheduled refresh of sanctions lists + GLEIF deltas (HTTP transport only).",
123
+ "format": "string",
124
+ "isRequired": false,
125
+ "default": "0 4 * * *"
126
+ },
127
+ {
128
+ "name": "SANCTIONS_FUZZY_MIN_SCORE",
129
+ "description": "Default Jaro-Winkler similarity floor (0-1) for fuzzy matches when the caller omits min_score.",
130
+ "format": "string",
131
+ "isRequired": false,
132
+ "default": "0.85"
133
+ },
134
+ {
135
+ "name": "SANCTIONS_FUZZY_MAX_RESULTS",
136
+ "description": "Hard cap on fuzzy candidates scored per query, to bound work on short queries.",
137
+ "format": "string",
138
+ "isRequired": false,
139
+ "default": "50"
140
+ }
141
+ ],
142
+ "transport": {
143
+ "type": "streamable-http",
144
+ "url": "http://localhost:3010/mcp"
145
+ }
146
+ }
147
+ ]
148
+ }