kotlin-lib-mcp
MCP server exposing Maven Kotlin/Java library sources, API signatures, and KDoc to AI clients.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
JDK 25+,Java 25+ runtime
download JDK 25 Temurin tarball via Adoptium API
curl -L --fail -o /tmp/jdk.tar.gz "https://api.adoptium.net/v3/binary/latest/25/ga/linux/x64/jdk/hotspot/normal/eclipse"extract JDK to /tmp/jdk and verify java -version
mkdir -p /tmp/jdk && tar -xzf /tmp/jdk.tar.gz -C /tmp/jdk --strip-components=1 && /tmp/jdk/bin/java -versiondownload kotlin-lib-mcp release zip v0.10.1 from GitHub
curl -L --fail -o /tmp/kotlin-lib.zip "https://github.com/aoreshkov/kotlin-lib-mcp/releases/download/v0.10.1/kotlin-lib-mcp-server-0.10.1.zip"unzip release zip to /tmp
mkdir -p $HOME/.local/bin unzip -q -o /tmp/kotlin-lib.zip -d /tmp export JAVA_HOME=/tmp/jdk && export PATH=$JAVA_HOME/bin:$PATH /tmp/kotlin-lib-mcp-server-0.10.1/bin/server --helpcreate wrapper script in ~/.local/bin that sets JAVA_HOME and execs server
cat > $HOME/.local/bin/kotlin-lib-mcp-server <<'EOS' #!/bin/sh export JAVA_HOME=/tmp/jdk export PATH="$JAVA_HOME/bin:$PATH" exec /tmp/kotlin-lib-mcp-server-0.10.1/bin/server "$@" EOS chmod +x $HOME/.local/bin/kotlin-lib-mcp-server $HOME/.local/bin/kotlin-lib-mcp-server --help
Check that it works
export JAVA_HOME=/tmp/jdk && export PATH=$JAVA_HOME/bin:$PATH
/tmp/kotlin-lib-mcp-server-0.10.1/bin/server --versionThe output should contain “kotlin-lib-mcp 0.10.1”.
Add it to your agent
claude mcp add kotlin-lib-mcp -- $HOME/.local/bin/kotlin-lib-mcp-server --transport stdioJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"kotlin-lib-mcp": {
"command": "sh",
"args": [
"-c",
"exec \"$HOME/.local/bin/kotlin-lib-mcp-server\" --transport stdio"
]
}
}
}Add kotlin-lib-mcp-server --transport stdio as an MCP server in your AI client, then ask it to use the library tools such as fetch_library.
What it does
- Fetch the real sources of Maven librariesTested
How to use it
- Connect your MCP client to
kotlin-lib-mcp-server --transport stdio. - Call the fetch_library tool with a Maven coordinate, for example {"coordinate":"<group>:<artifact>:<version>"}.
- Read the returned text and resource link for the fetched library.
- Connect your MCP client to
- See a library's public API and KDocNot shown working
- Read and search library source codeNot shown working
- Compare versions and public API changesNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 1 of 4 features work
- Needs the network
Good for
- fetch and cache a Maven library for analysis
- get resolved signature of a declaration by name
- read KDoc for a library declaration
- compare public API between two library versions
- search raw library source and read implementation
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Needed the network
- Checked on 1 Nov 2026
- Version 0.10.1
An MCP client handshake over stdio listed 12 tools, and a call to fetch_library returned a result.
Differences the test machine hit
- README: Requires JDK 25+ runtime
In the test: No JDK preinstalled; manually downloaded Temurin JDK 25.0.5 tarball from api.adoptium.net and extracted to /tmp/jdk, set JAVA_HOME - README: claude mcp add kotlin-lib -- /path/to/kotlin-lib-mcp-server-<version>/bin/server --transport stdio
In the test: Created wrapper ~/.local/bin/kotlin-lib-mcp-server that exports JAVA_HOME=/tmp/jdk before exec; direct bin/server needs JAVA_HOME set to JDK 25