mail_mcp 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.
data/lib/mail_mcp.rb ADDED
@@ -0,0 +1,26 @@
1
+ require "base64"
2
+ require "json"
3
+
4
+ require_relative "mail_mcp/version"
5
+
6
+ module MailMCP
7
+ end
8
+
9
+ require_relative "mail_mcp/jwt_service"
10
+ require_relative "mail_mcp/pkce"
11
+ require_relative "mail_mcp/imap_client"
12
+ require_relative "mail_mcp/smtp_client"
13
+ require_relative "mail_mcp/attachment_store"
14
+ require_relative "mail_mcp/credential_context"
15
+ require_relative "mail_mcp/mail_builder"
16
+ require_relative "mail_mcp/tool"
17
+ require_relative "mail_mcp/tools/list_mailboxes_tool"
18
+ require_relative "mail_mcp/tools/list_mail_messages_tool"
19
+ require_relative "mail_mcp/tools/get_mail_message_tool"
20
+ require_relative "mail_mcp/tools/search_mail_messages_tool"
21
+ require_relative "mail_mcp/tools/send_mail_message_tool"
22
+ require_relative "mail_mcp/tools/create_draft_mail_message_tool"
23
+ require_relative "mail_mcp/tools/delete_mail_message_tool"
24
+ require_relative "mail_mcp/tools/move_mail_message_tool"
25
+ require_relative "mail_mcp/tools/update_mail_message_flags_tool"
26
+ require_relative "mail_mcp/app"
data/views/login.erb ADDED
@@ -0,0 +1,128 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Mail MCP — Connect</title>
7
+ <style>
8
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
9
+ body {
10
+ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
11
+ background: #f5f5f7;
12
+ display: flex;
13
+ justify-content: center;
14
+ align-items: center;
15
+ min-height: 100vh;
16
+ padding: 1rem;
17
+ }
18
+ .card {
19
+ background: #fff;
20
+ border-radius: 12px;
21
+ box-shadow: 0 4px 24px rgba(0,0,0,0.10);
22
+ padding: 2.5rem 2rem;
23
+ width: 100%;
24
+ max-width: 420px;
25
+ }
26
+ h1 { font-size: 1.4rem; font-weight: 700; margin-bottom: 0.25rem; color: #1d1d1f; }
27
+ .subtitle { font-size: 0.9rem; color: #6e6e73; margin-bottom: 0.5rem; }
28
+ .server-info {
29
+ font-size: 0.8rem; color: #6e6e73;
30
+ background: #f5f5f7; border-radius: 6px;
31
+ padding: 0.5rem 0.75rem; margin-bottom: 1.5rem;
32
+ }
33
+ .server-info span { font-weight: 600; color: #1d1d1f; }
34
+ .error {
35
+ background: #fff2f2;
36
+ border: 1px solid #ffcdd2;
37
+ color: #b71c1c;
38
+ border-radius: 8px;
39
+ padding: 0.75rem 1rem;
40
+ font-size: 0.875rem;
41
+ margin-bottom: 1.25rem;
42
+ }
43
+ label { display: block; font-size: 0.8rem; font-weight: 600; color: #1d1d1f; margin-bottom: 0.3rem; margin-top: 1rem; }
44
+ input[type="text"], input[type="password"] {
45
+ width: 100%; border: 1px solid #d2d2d7; border-radius: 8px;
46
+ padding: 0.6rem 0.75rem; font-size: 0.95rem; color: #1d1d1f;
47
+ transition: border-color 0.15s;
48
+ }
49
+ input:focus { outline: none; border-color: #0071e3; box-shadow: 0 0 0 3px rgba(0,113,227,0.15); }
50
+ .section-title {
51
+ font-size: 0.7rem; font-weight: 700; letter-spacing: 0.08em;
52
+ text-transform: uppercase; color: #6e6e73; margin-top: 1.5rem; margin-bottom: 0.25rem;
53
+ }
54
+ .checkbox-row {
55
+ display: flex; align-items: center; gap: 0.5rem;
56
+ margin-top: 1rem; margin-bottom: 0.25rem;
57
+ }
58
+ .checkbox-row input[type="checkbox"] { width: 1rem; height: 1rem; cursor: pointer; }
59
+ .checkbox-row label { margin: 0; font-size: 0.875rem; font-weight: 400; color: #1d1d1f; cursor: pointer; }
60
+ button[type="submit"] {
61
+ width: 100%; margin-top: 1.75rem;
62
+ background: #0071e3; color: #fff; border: none;
63
+ border-radius: 8px; padding: 0.75rem; font-size: 1rem; font-weight: 600;
64
+ cursor: pointer; transition: background 0.15s;
65
+ }
66
+ button[type="submit"]:hover { background: #0077ed; }
67
+ </style>
68
+ </head>
69
+ <body>
70
+ <div class="card">
71
+ <h1>Mail MCP</h1>
72
+ <p class="subtitle">Connect your email account to continue</p>
73
+ <div class="server-info">
74
+ IMAP <span><%= @params[:imap_host] %></span> &nbsp;·&nbsp;
75
+ SMTP <span><%= @params[:smtp_host] %></span>
76
+ </div>
77
+
78
+ <% if @params[:error] %>
79
+ <div class="error"><%= @params[:error] %></div>
80
+ <% end %>
81
+
82
+ <form method="POST" action="/oauth/authorize">
83
+ <input type="hidden" name="client_id" value="<%= @params[:client_id] %>">
84
+ <input type="hidden" name="redirect_uri" value="<%= @params[:redirect_uri] %>">
85
+ <input type="hidden" name="state" value="<%= @params[:state] %>">
86
+ <input type="hidden" name="code_challenge" value="<%= @params[:code_challenge] %>">
87
+ <input type="hidden" name="code_challenge_method" value="<%= @params[:code_challenge_method] %>">
88
+
89
+ <div class="section-title">IMAP (Incoming)</div>
90
+
91
+ <label for="imap_username">IMAP Username</label>
92
+ <input type="text" id="imap_username" name="imap_username"
93
+ placeholder="you@example.com" autocomplete="username" required>
94
+
95
+ <label for="imap_password">IMAP Password</label>
96
+ <input type="password" id="imap_password" name="imap_password"
97
+ placeholder="••••••••" autocomplete="current-password" required>
98
+
99
+ <div class="checkbox-row">
100
+ <input type="checkbox" id="use_same" name="use_same_credentials" value="1" checked>
101
+ <label for="use_same">Use the same username and password for SMTP</label>
102
+ </div>
103
+
104
+ <div id="smtp-fields" style="display:none">
105
+ <div class="section-title">SMTP (Outgoing)</div>
106
+
107
+ <label for="smtp_username">SMTP Username</label>
108
+ <input type="text" id="smtp_username" name="smtp_username"
109
+ placeholder="you@example.com" autocomplete="username">
110
+
111
+ <label for="smtp_password">SMTP Password</label>
112
+ <input type="password" id="smtp_password" name="smtp_password"
113
+ placeholder="••••••••" autocomplete="current-password">
114
+ </div>
115
+
116
+ <button type="submit">Connect</button>
117
+ </form>
118
+ </div>
119
+
120
+ <script>
121
+ const checkbox = document.getElementById('use_same');
122
+ const smtpFields = document.getElementById('smtp-fields');
123
+ function toggle() { smtpFields.style.display = checkbox.checked ? 'none' : 'block'; }
124
+ checkbox.addEventListener('change', toggle);
125
+ toggle();
126
+ </script>
127
+ </body>
128
+ </html>
metadata ADDED
@@ -0,0 +1,207 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: mail_mcp
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Edgars Beigarts
8
+ bindir: bin
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: aws-sdk-s3
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '1.0'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '1.0'
26
+ - !ruby/object:Gem::Dependency
27
+ name: base64
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - "~>"
31
+ - !ruby/object:Gem::Version
32
+ version: '0.2'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '0.2'
40
+ - !ruby/object:Gem::Dependency
41
+ name: json-jwt
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '1.16'
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '1.16'
54
+ - !ruby/object:Gem::Dependency
55
+ name: mail
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '2.8'
61
+ type: :runtime
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '2.8'
68
+ - !ruby/object:Gem::Dependency
69
+ name: mcp
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - "~>"
73
+ - !ruby/object:Gem::Version
74
+ version: '0.14'
75
+ type: :runtime
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - "~>"
80
+ - !ruby/object:Gem::Version
81
+ version: '0.14'
82
+ - !ruby/object:Gem::Dependency
83
+ name: puma
84
+ requirement: !ruby/object:Gem::Requirement
85
+ requirements:
86
+ - - "~>"
87
+ - !ruby/object:Gem::Version
88
+ version: '6.0'
89
+ type: :runtime
90
+ prerelease: false
91
+ version_requirements: !ruby/object:Gem::Requirement
92
+ requirements:
93
+ - - "~>"
94
+ - !ruby/object:Gem::Version
95
+ version: '6.0'
96
+ - !ruby/object:Gem::Dependency
97
+ name: rack
98
+ requirement: !ruby/object:Gem::Requirement
99
+ requirements:
100
+ - - "~>"
101
+ - !ruby/object:Gem::Version
102
+ version: '3.0'
103
+ type: :runtime
104
+ prerelease: false
105
+ version_requirements: !ruby/object:Gem::Requirement
106
+ requirements:
107
+ - - "~>"
108
+ - !ruby/object:Gem::Version
109
+ version: '3.0'
110
+ - !ruby/object:Gem::Dependency
111
+ name: securerandom
112
+ requirement: !ruby/object:Gem::Requirement
113
+ requirements:
114
+ - - ">="
115
+ - !ruby/object:Gem::Version
116
+ version: '0'
117
+ type: :runtime
118
+ prerelease: false
119
+ version_requirements: !ruby/object:Gem::Requirement
120
+ requirements:
121
+ - - ">="
122
+ - !ruby/object:Gem::Version
123
+ version: '0'
124
+ - !ruby/object:Gem::Dependency
125
+ name: sinatra
126
+ requirement: !ruby/object:Gem::Requirement
127
+ requirements:
128
+ - - "~>"
129
+ - !ruby/object:Gem::Version
130
+ version: '4.0'
131
+ type: :runtime
132
+ prerelease: false
133
+ version_requirements: !ruby/object:Gem::Requirement
134
+ requirements:
135
+ - - "~>"
136
+ - !ruby/object:Gem::Version
137
+ version: '4.0'
138
+ - !ruby/object:Gem::Dependency
139
+ name: sinatra-contrib
140
+ requirement: !ruby/object:Gem::Requirement
141
+ requirements:
142
+ - - "~>"
143
+ - !ruby/object:Gem::Version
144
+ version: '4.0'
145
+ type: :runtime
146
+ prerelease: false
147
+ version_requirements: !ruby/object:Gem::Requirement
148
+ requirements:
149
+ - - "~>"
150
+ - !ruby/object:Gem::Version
151
+ version: '4.0'
152
+ description: A Model Context Protocol server providing IMAP/SMTP email tools behind
153
+ an OAuth 2.1 authorization server.
154
+ email:
155
+ - edgars.beigarts@mitigate.dev
156
+ executables:
157
+ - mail_mcp
158
+ extensions: []
159
+ extra_rdoc_files: []
160
+ files:
161
+ - README.md
162
+ - bin/mail_mcp
163
+ - config.ru
164
+ - config/puma.rb
165
+ - lib/mail_mcp.rb
166
+ - lib/mail_mcp/app.rb
167
+ - lib/mail_mcp/attachment_store.rb
168
+ - lib/mail_mcp/credential_context.rb
169
+ - lib/mail_mcp/imap_client.rb
170
+ - lib/mail_mcp/jwt_service.rb
171
+ - lib/mail_mcp/mail_builder.rb
172
+ - lib/mail_mcp/pkce.rb
173
+ - lib/mail_mcp/smtp_client.rb
174
+ - lib/mail_mcp/tool.rb
175
+ - lib/mail_mcp/tools/create_draft_mail_message_tool.rb
176
+ - lib/mail_mcp/tools/delete_mail_message_tool.rb
177
+ - lib/mail_mcp/tools/get_mail_message_tool.rb
178
+ - lib/mail_mcp/tools/list_mail_messages_tool.rb
179
+ - lib/mail_mcp/tools/list_mailboxes_tool.rb
180
+ - lib/mail_mcp/tools/move_mail_message_tool.rb
181
+ - lib/mail_mcp/tools/search_mail_messages_tool.rb
182
+ - lib/mail_mcp/tools/send_mail_message_tool.rb
183
+ - lib/mail_mcp/tools/update_mail_message_flags_tool.rb
184
+ - lib/mail_mcp/version.rb
185
+ - views/login.erb
186
+ licenses:
187
+ - MIT
188
+ metadata:
189
+ rubygems_mfa_required: 'true'
190
+ rdoc_options: []
191
+ require_paths:
192
+ - lib
193
+ required_ruby_version: !ruby/object:Gem::Requirement
194
+ requirements:
195
+ - - ">="
196
+ - !ruby/object:Gem::Version
197
+ version: '3.4'
198
+ required_rubygems_version: !ruby/object:Gem::Requirement
199
+ requirements:
200
+ - - ">="
201
+ - !ruby/object:Gem::Version
202
+ version: '0'
203
+ requirements: []
204
+ rubygems_version: 3.6.9
205
+ specification_version: 4
206
+ summary: Hosted MCP server for IMAP and SMTP email.
207
+ test_files: []