Skip to content

Commit e2257d2

Browse files
bilby91bilby91
committed
feat: Initial implementation
0 parents  commit e2257d2

File tree

18 files changed

+3141
-0
lines changed

18 files changed

+3141
-0
lines changed

‎.devcontainer/devcontainer.json‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
{
2+
"name": "mcp-teamtailor",
3+
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
4+
"workspaceFolder": "/workspaces/mcp-teamtailor",
5+
"features": {
6+
"ghcr.io/devcontainers/features/node:1": {
7+
"version": "22.12.0"
8+
},
9+
"ghcr.io/devcontainers/features/docker-in-docker:2": {
10+
"version": "28.0.4"
11+
},
12+
"ghcr.io/devcontainers/features/python:1": {
13+
"version": "3.13.1",
14+
"toolsToInstall": "aider-install"
15+
}
16+
},
17+
"postCreateCommand": ".devcontainer/post-create.sh",
18+
"customizations": {
19+
"vscode": {
20+
"extensions": [
21+
"streetsidesoftware.code-spell-checker",
22+
"dbaeumer.vscode-eslint",
23+
"GitHub.copilot",
24+
"GitHub.copilot-chat",
25+
"mhutchie.git-graph",
26+
"eamodio.gitlens",
27+
"esbenp.prettier-vscode"
28+
]
29+
}
30+
}
31+
}

‎.devcontainer/post-create.sh‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
#!/bin/bash
2+
3+
# Ensure the script fails if any command fails
4+
set -e
5+
6+
# Install npm dependencies
7+
npm install

‎.dockerignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
dist

‎.github/workflows/ci.yaml‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
name: Continuous Integration
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
pull_request:
8+
branches:
9+
- main
10+
11+
jobs:
12+
build:
13+
runs-on: ubuntu-latest
14+
steps:
15+
- name: Checkout code
16+
uses: actions/checkout@v2
17+
- name: Set NodeJS
18+
uses: actions/setup-node@v4
19+
with:
20+
node-version: '22.12.0'
21+
cache: 'npm'
22+
- run: npm ci
23+
- run: npm run build
24+
eslint:
25+
runs-on: ubuntu-latest
26+
steps:
27+
- name: Checkout code
28+
uses: actions/checkout@v2
29+
- name: Set NodeJS
30+
uses: actions/setup-node@v4
31+
with:
32+
node-version: '22.12.0'
33+
cache: 'npm'
34+
- run: npm ci
35+
- name: Run ESLint
36+
run: npx eslint

‎.github/workflows/release.yaml‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
name: Publish Package to npmjs
2+
on:
3+
release:
4+
types: [published]
5+
jobs:
6+
publish:
7+
runs-on: ubuntu-latest
8+
permissions:
9+
contents: read
10+
id-token: write
11+
steps:
12+
- uses: actions/checkout@v4
13+
- uses: actions/setup-node@v4
14+
with:
15+
node-version: '22.12.0'
16+
registry-url: 'https://registry.npmjs.org'
17+
- run: npm ci
18+
- run: npm publish --provenance --access public
19+
env:
20+
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

‎.gitignore‎

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
# Logs
2+
logs
3+
*.log
4+
npm-debug.log*
5+
yarn-debug.log*
6+
yarn-error.log*
7+
lerna-debug.log*
8+
.pnpm-debug.log*
9+
10+
# Diagnostic reports (https://nodejs.org/api/report.html)
11+
report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
12+
13+
# Runtime data
14+
pids
15+
*.pid
16+
*.seed
17+
*.pid.lock
18+
19+
# Directory for instrumented libs generated by jscoverage/JSCover
20+
lib-cov
21+
22+
# Coverage directory used by tools like istanbul
23+
coverage
24+
*.lcov
25+
26+
# nyc test coverage
27+
.nyc_output
28+
29+
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
30+
.grunt
31+
32+
# Bower dependency directory (https://bower.io/)
33+
bower_components
34+
35+
# node-waf configuration
36+
.lock-wscript
37+
38+
# Compiled binary addons (https://nodejs.org/api/addons.html)
39+
build/Release
40+
41+
# Dependency directories
42+
node_modules/
43+
jspm_packages/
44+
45+
# Snowpack dependency directory (https://snowpack.dev/)
46+
web_modules/
47+
48+
# TypeScript cache
49+
*.tsbuildinfo
50+
51+
# Optional npm cache directory
52+
.npm
53+
54+
# Optional eslint cache
55+
.eslintcache
56+
57+
# Optional stylelint cache
58+
.stylelintcache
59+
60+
# Microbundle cache
61+
.rpt2_cache/
62+
.rts2_cache_cjs/
63+
.rts2_cache_es/
64+
.rts2_cache_umd/
65+
66+
# Optional REPL history
67+
.node_repl_history
68+
69+
# Output of 'npm pack'
70+
*.tgz
71+
72+
# Yarn Integrity file
73+
.yarn-integrity
74+
75+
# dotenv environment variable files
76+
.env
77+
.env.development.local
78+
.env.test.local
79+
.env.production.local
80+
.env.local
81+
82+
# parcel-bundler cache (https://parceljs.org/)
83+
.cache
84+
.parcel-cache
85+
86+
# Next.js build output
87+
.next
88+
out
89+
90+
# Nuxt.js build / generate output
91+
.nuxt
92+
dist
93+
94+
# Gatsby files
95+
.cache/
96+
# Comment in the public line in if your project uses Gatsby and not Next.js
97+
# https://nextjs.org/blog/next-9-1#public-directory-support
98+
# public
99+
100+
# vuepress build output
101+
.vuepress/dist
102+
103+
# vuepress v2.x temp and cache directory
104+
.temp
105+
.cache
106+
107+
# vitepress build output
108+
**/.vitepress/dist
109+
110+
# vitepress cache directory
111+
**/.vitepress/cache
112+
113+
# Docusaurus cache and generated files
114+
.docusaurus
115+
116+
# Serverless directories
117+
.serverless/
118+
119+
# FuseBox cache
120+
.fusebox/
121+
122+
# DynamoDB Local files
123+
.dynamodb/
124+
125+
# TernJS port file
126+
.tern-port
127+
128+
# Stores VSCode versions used for testing VSCode extensions
129+
.vscode-test
130+
131+
# yarn v2
132+
.yarn/cache
133+
.yarn/unplugged
134+
.yarn/build-state.yml
135+
.yarn/install-state.gz
136+
.pnp.*
137+
.aider*

‎.vscode/settings.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"cSpell.words": [
3+
"crunchloop",
4+
"teamtailor"
5+
]
6+
}

‎Dockerfile‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
FROM node:22.14-alpine AS builder
2+
3+
COPY . /app
4+
COPY tsconfig.json /tsconfig.json
5+
6+
WORKDIR /app
7+
8+
RUN --mount=type=cache,target=/root/.npm npm install
9+
RUN --mount=type=cache,target=/root/.npm-production npm ci --ignore-scripts --omit-dev
10+
11+
FROM node:22-alpine AS release
12+
13+
COPY --from=builder /app/dist /app/dist
14+
COPY --from=builder /app/package.json /app/package.json
15+
COPY --from=builder /app/package-lock.json /app/package-lock.json
16+
17+
ENV NODE_ENV=production
18+
19+
WORKDIR /app
20+
21+
RUN npm ci --ignore-scripts --omit-dev
22+
23+
ENTRYPOINT ["node", "dist/index.js"]

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 Crunchloop
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# mcp-teamtailor
2+
3+
The MCP Teamtailor is a Model Context Protocol (MCP) server that provides a simple integration with the [teamtailor api](https://docs.teamtailor.com/).
4+
5+
## Dependencies
6+
7+
No other dependencies are required to use the MCP Teamtailor server.
8+
9+
## Usage
10+
11+
MCP servers are configured differently depending on the client that you are using. For reference, this is how you would configure it using Claude Desktop.
12+
13+
```json
14+
{
15+
"mcpServers": {
16+
"teamtailor": {
17+
"command": "npx",
18+
"args": [
19+
"-y",
20+
"@crunchloop/mcp-teamtailor"
21+
],
22+
"env": {
23+
"TEAMTAILOR_URL": "https://api.teamtailor.com/v1",
24+
"TEAMTAILOR_API_KEY": "XXXX"
25+
}
26+
}
27+
}
28+
}
29+
```
30+
31+
## MCP Transport
32+
33+
At the moment, only `stdio` transport has been implemented.
34+
35+
## Tools
36+
37+
- **teamtailor_list_candidates** - List and filter candidates.
38+
- `pageSize`: The size of the page response (string, optional)
39+
- `page`: The page number to retrieve (string, optional)
40+
- `filter.createdAfter`: Filter candidates created after a specific date (string, optional)
41+
- `filter.createdBefore`: Filter candidates created before a specific date (string, optional)
42+
- `filter.updatedAfter`: Filter candidates updated after a specific date (string, optional)
43+
- `filter.updatedBefore`: Filter candidates updated before a specific date (string, optional)
44+
45+
- **teamtailor_get_candidate** - Get a single candidate by their id.
46+
- `candidateId`: The id of the candidate to retrieve (number, required)
47+
48+
## License
49+
50+
Released under the MIT License. See the [LICENSE](./LICENSE) file for further details.

0 commit comments

Comments
 (0)