This repository was archived by the owner on Apr 8, 2025. It is now read-only.
Add Tutorial for Creating an MCP Client in Typescript #147
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
allenzhou101
changed the title
allenzhou101
changed the title
9 tasks
allenzhou101
changed the title
dsp-ant
approved these changes
Mar 10, 2025
| - Mac or Windows computer | ||
| - Node.js 16 or higher installed | ||
| - Latest version of `npm` and `npx` installed | ||
| - Anthropic API key (Claude) |
There was a problem hiding this comment.
We should probably clarify that others can be used, but this tutorial uses Claude.
| import readline from "readline/promises"; | ||
| import dotenv from "dotenv"; | ||
|
|
||
| dotenv.config(); |
There was a problem hiding this comment.
Maybe we should add a comment that these specific bits are for?
Comment on lines
+528
to
+563
| async connectToServer(serverScriptPath: string) { | ||
| try { | ||
| const isJs = serverScriptPath.endsWith(".js"); | ||
| const isPy = serverScriptPath.endsWith(".py"); | ||
| if (!isJs && !isPy) { | ||
| throw new Error("Server script must be a .js or .py file"); | ||
| } | ||
| const command = isPy | ||
| ? process.platform === "win32" | ||
| ? "python" | ||
| : "python3" | ||
| : process.execPath; | ||
|
|
||
| this.transport = new StdioClientTransport({ | ||
| command, | ||
| args: [serverScriptPath], | ||
| }); | ||
| this.mcp.connect(this.transport); | ||
|
|
||
| const toolsResult = await this.mcp.listTools(); | ||
| this.tools = toolsResult.tools.map((tool) => { | ||
| return { | ||
| name: tool.name, | ||
| description: tool.description, | ||
| input_schema: tool.inputSchema, | ||
| }; | ||
| }); | ||
| console.log( | ||
| "Connected to server with tools:", | ||
| this.tools.map(({ name }) => name) | ||
| ); | ||
| } catch (e) { | ||
| console.log("Failed to connect to MCP server: ", e); | ||
| throw e; | ||
| } | ||
| } |
There was a problem hiding this comment.
Specialcasing .js or .py might give the impression that this is the standard behaviour. I would prefer if we assume we read the configs from a json or yaml file.
tzolov
pushed a commit
to tzolov/modelcontextprotocol-docs
that referenced
this pull request
Mar 20, 2025
…otocol#147) * Add mcp-client-typescript quickstart guide * Improve client running explanation, best practices, etc. * Set new python mcp client github link * Only call list tools at initialization * Add package.json and tsconfig.json setup section --------- Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com>
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR relies on the
quickstart-resourcesPR merging first as it links to the Python and Typescript MCP clients.Specifically, this change will add a section to the Quickstart For Client Developers focused on Node/Typescript
Motivation and Context
MCP Client tutorials exist for Python and Java but not Node. Including this section improves the DX for MCP Client developers.
How Has This Been Tested?
The code in this tutorial was validated via connecting to multiple MCP Servers locally.
Breaking Changes
None
Types of changes
Checklist
Additional context
Fixes #103